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Vorwort 


Das  Stichwort  grafische  Benutzeroberflache  ist  aus  dem  Computeralltag  kaum  noch  weg- 
zudenken.  Alles  deutet  darauf  hin,  dafi  eine  neue  Revolution  der  Mensch-Maschine- 
Schnittstelle  auf  die  Softwareentwickler  zukommt.  Diese  Tatsache  kann  man  im  Kampf 
ablesen,  der  vor  allem  auf  dem  Unix-Markt  voll  im  Gange  ist. 


AT&T  bringen  mit  Sun  das  Open-Look-System  heraus,  von  OSF  (Open  Software  Foun- 
dation) kommt  das  System  Motif.  Beide  basieren  auf  dem  System  X- Windows.  Microsoft 
schlieBlich  kommt  mit  dem  Presentation  Manager  (PM).  Digital  Research  ist  mit  GEM 
schon  seit  einigen  Jahren  auf  dem  Markt,  wobei  GEM  vor  allem  durch  die  Einfiihrung 
des  ATARI  ST  an  Bekanntheit  gewonnen  hat. 

Doch  mit  dem  Vorhandensein  einer  grafischen  Benutzeroberflache  allein  ist  noch  lange 
nicht  garantiert,  dab  ein  Softwaresystem  auch  den  Wiinschen  des  Anwenders  entspricht. 


Die  Entwicklung  von  Software  unter  grafischen  Oberflachen  setzt  hauptsachlich  2 Kom- 
ponenten  voraus: 

- das  Programmer’s  Toolkit 

- Richtlinien  oder  sogenannte  Style  Guidelines 

Das  Toolkit  bildet  den  Kern  der  programmiertechnischen  Seite.  Mit  dessen  Hilfe  konnen 
Softwarepakete  effizient  erstellt  werden.  Prototyping,  Erstellung  von  Dialogboxen  und 
Masken  sowie  die  unabhangige  Programmierung  von  internationalen  Programmversio- 
nen  werden  durch  das  Toolkit  erst  ermoglicht. 

GroBte  Bedeutung  hat  aber  neben  den  programmiertechnischen  Voraussetzungen  das 
Vorhandensein  von  Style  Guidelines.  Sie  garantieren,  dal)  Softwarepakete  nicht  das  Pro- 
dukt  aus  spontaner  Kreativitat  und  Willkiir  einzelner  Programmierer  sind,  Sie  sorgen  fur 
Konformitat  auch  unter  einer  groBeren  Palette  von  Applikationen  verschiedener  Her- 
steller. 
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Vonvort 


Style  Guidelines  minimieren  auch  die  Entwicklungszeiten  fiir  Oberflachen,  da  sich  Pro- 
grammierer  nicht  mehr  mit  langwierigen  Uberlegungen  herumschlagen  miissen,  wie  Pull- 
Down-Meniis,  Dialogboxen  und  Interaktionen  mit  Bildschirmfenstern  auszusehen  haben. 

Durch  das  Benutzen  von  Guidelines  bei  der  Softwareentwicklung  wird  gewahrleistet,  dafi 
der  Anwender  iiber  verschiedene  Applikationen  hinweg  auf  bereits  gewonnene  Erfahrun- 
gen  zuriickgreifen  kann,  was  wiedenim  zu  einer  hohen  Akzeptanz  der  Software  fiihrt. 

Nur  Apple  ist  es  bisher  gelungen,  Richtlinien  fur  Entwickler  bereitzustellen,  um  die  Kon- 
sistenz  zwischen  verschiedenen  Applikationen  sicherzustellen.  Diese  Richtlinien  sind  in 
dem  Werk  INSIDE  MACINTOSH  festgehalten.  Wer  als  Anwender  einmal  auf  einem  Ma- 
cintosh gearbeitet  hat,  wird  mit  dem  Erlernen  von  neuen  Applikationen  kaum  noch  Pro- 
bleme  haben. 

Ein  entsprechendes  Werk  fur  GEM,  das  von  Digital  Research  oder  ATARI  herausgege- 
ben  wurde,  war  bisher  noch  nicht  in  Sicht.  Es  ist  Aufgabe  dieses  Buches,  das  Fehlende 
jetzt  nachzuholen.  Deshalb  konnen  Sie  dieses  Werk  als  INSIDE  GEM  ansehen,  das  Soft- 
wareentwicklung unter  GEM  inklusive  Theorie  der  Benutzeroberflachen  vollstandig  be- 
schreibt.  Es  entstand  in  Zusammenarbeit  mit  ATARI  Computer  GmbH  und  Digital  Re- 
search. Das  neue  Programmer’s  Toolkit  von  DRI  enthalt  auch  die  Programmierumgebung 
fiir  die  verschiedenen  Systeme  (PORTAB.H,  VDI.H  und  AES.H),  wahrend  ATARI  die 
Regeln  fur  die  Gestaltung  von  GEM-Software  voll  ubernommen  hat  und  dieses  Werk  je- 
dem  Softwareentwickler  ans  Herz  legt. 

Das  Buch  enthalt  eine  komplette  Programmierumgebung  fiir  GEM-Soflware,  so  dafi  Ent- 
wickler nur  noch  einen  minimalen  Aufwand  betreiben  mussen,  um  perfekte  Software  un- 
ter GEM  zu  erstellen.  Sie  mussen  lediglich  die  Funktionaiitat  Ihrer  Applikation  an  das 
vorhandene  Skelett-Programm  SCRAP  anhangen  und  die  Regeln  in  Kapitel  5 beachten. 
Die  komplexe  Steuerung  von  Software  unter  einer  grafischen  Oberflache  wird  Ihnen  da- 
bei  komplett  abgenommen. 
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1 Einleitung 


Seit  dem  Erscheinen  des  Atari  ST  auf  dem  deutschen  Markt  wurden  mehrere  hundert- 
tausend  Gerate  abgesetzt.  Diese  Beliebtheit  ist  einerseits  dem  giinstigen  Preis-Leistungs- 
Verhaltnis  zuzurechnen,  andererseits  aber  auch  der  einfachen  Bedienung.  Sie  resultiert 
aus  dem  Vorhandensein  der  grafischen  Benutzeroberfliiche  GEM  (Graphics  Environment 
Manager),  die  beim  Atari  ST  standardmaBig  mitgeliefert  wird. 


So  konnen  auch  Personen,  die  noch  nie  oder  sehr  selten  mit  Rechnern  umgegangen  sind, 
die  Beriihrungsangste  genommen  werden.  Beispielsweise  werden  Atari-Rechner  wegen 
der  leichten  Bedienbarkeit  bestimmter  Programme  sogar  beim  deutschen  Bundesgerichts- 
hof  eingesetzt. 


Das  GEM  der  Firma  Digital  Research  Incorporated,  welche  manchmal  auch  DRI  genannt 
wird,  war  bereits  vorhanden,  bevor  es  den  Atari  ST  gab.  Es  wurde  urspriinglich  fur  IBM 
PC  und  Kompatible  geschaffen.  Atari  hat  dann  die  Lizenzen  fiir  eine  Version  fiir  ihren 
ST  eingekauft.  Auf  dem  IBM  PC  fristete  GEM  jedoch  ein  eher  stiefmiitterliches  Dasein, 
da  es  erstens  extra  gekauft  werden  muBte  und  es  zweitens  nicht  geniigend  gute  Software 
gab. 


Es  ist  nun  zu  beobachten,  daB  immer  mehr  Programme,  die  urspriinglich  fur  den  Atari 
entwickelt  werden,  auch  auf  dem  IBM  laufen  konnen.  Allerdings  wurde  das  GEM  fur 
die  PCs  weiterentwickelt,  so  daB  es  nun  eine  Reihe  von  verschiedenen  Versionen  gibt. 
Genannt  seien  hier  GEM  2. 1 , GEM  2.2  oder  GEM/3.  Letzteres  liegt  inzwischen  wieder 
in  der  Version  GEM  3.11  vor.  Ganz  neu  ist  X/GEM.  Dieses  Extended  GEM  ist  eine  grafi 
sche  Oberflache,  die  nur  unter  einem  Multitasking-Betriebssystem  lauft,  also  z.B. 
FLEXOS  (von  DRI).  Dieses  bietet  dann  aber  auch  Mbglichkeiten,  von  denen  Atari- 
Besitzer  nur  traumen  konnen.  Mehrere  Prozesse  konnen  in  eigenen  Fenstern  parallel  ab- 
laufen  (oder  wenigstens  quasiparallel  bei  Einsatz  nur  eines  Mikroprozessors). 


Demgegentiber  hat  Atari  keine  neue  GEM-Version  von  DRI  gekauft,  so  daB  auf  diesem 
Rechner  immer  noch  das  „alte“  GEM  lauft  (Versionsnummer  kleiner  2). 


12 


I Einleitung 


Wahrend  der  Atari  ST  von  Haus  aus  drei  verschiedene  Auflosungen  bietet,  mufl  beim 
GEM  fUr  den  PC  beim  Installieren  angegeben  werden,  welche  Grafikkarte  man  sein  eigen 
nennt.  AuBerdem  gibt  es  noch  die  Mbglichkeit,  verschiedene  GroBbildschirme  an  den 
Rechner  anzuschlieBen.  Es  ist  wohl  offensichtlich,  daB  GEM-Software  zumindest  so  ent- 
wickelt  werden  muB,  daB  sie  moglichst  mit  jeder  Bildschirmauflosung  lauft. 


Fiir  den  neuen  Atari  TT  gibt  es  sogar  noch  mehr  Bildschirmauflosungen.  Um  Programme 
auf  diesen  Rechner  anzupassen,  miissen  sie  schon  einigermaBen  sauber  programmiert 
sein. 


Desweiteren  kann  man  noch  unterscheiden,  ob  ein  Programm  als  Haupt-Applikation  im 
Vordergrund  lauft  oder  als  Accessory  im  Hintergrund.  Accessories  haben  normalerweise 
keine  eigene  Menuzeile  und  keinen  eigenen  Desktop.  Beim  X/GEM  entfallt  dies,  da  jedes 
Programm  im  Vorder-  oder  Hintergund  ablaufen  kann. 


Ein  weiterer  Stolperstein  kann  der  Einsatz  der  Entwicklungswerkzeuge  sein.  Geht  man 
beispielsweise  von  der  Sprache  „C“  aus,  in  der  auch  das  GEM  entwickelt  wurde,  so  fin- 
det  man  eine  Vielzahl  von  Compilern  auf  dem  jeweiligen  Rechner.  Wahrend  sich  beim 
IBM  alle  Compiler  einigermaBen  an  den  Microsoft-Standard  halten,  kocht  beim  Atari  je- 
der sein  eigenes  Suppchen.  Sogar  einige  Systemaufrufe  der  GEM-Bibliotheken  haben 
verschiedene  Namen,  von  den  Inkompatibilitaten  der  erzeugten  Objekt-Dateien  einmal 
ganz  zu  schweigen. 


Es  scheint  nun  geradezu  unmoglich,  GEM-Software  so  zu  entwickeln,  daB  sie  auf  jedem 
Rechner  mit  jedem  Betriebssystem,  mit  jeder  Auflosung,  mit  jeder  GEM-Version,  als 
Programm  oder  Accessory  mit  jedem  Compiler  lauft. 


Wiinschenswert  ware  eine  Methode,  Software  so  zu  entwickeln,  daB  sie  von  selbst  er- 
kennt,  in  welcher  Umgebung  und  wie  sie  abzulaufen  hat,  wobei  die  Software  nicht  modi- 
fiziert  werden  muB.  Beim  Compilieren  sollte  auflerdem  der  Quelltext  nicht  geandert  wer- 
den miissen,  wenn  von  einem  Compiler  auf  einen  anderen  oder  von  einem  Betriebssystem 
auf  ein  anderes  gewechselt  wird. 


Sie  sind  sicher  interessiert  daran,  Ihre  Software  genauso  zu  entwickeln  und  suchen  dafiir 
eine  Methode.  Die  in  diesem  Buch  dargestellte  Methode  erfullt  genau  die  oben  angegebe- 
nen  Forderungen.  Wenn  Ihnen  das  unglaubhaft  erscheint,  so  konnen  wir  Ihnen  nur  emp- 
fehlen,  das  Buch  durchzuarbeiten.  Dabei  spielt  es  keine  Rolle,  ob  Sie  Anfanger  oder  Fort- 
geschrittener  sind,  da  wir  von  vorne  anfangen  werden.  Die  einzigen  Voraussetzungen 
sind: 


- Kenntnis  der  Programmiersprache  C 

- Ein  C-Compiler 

- Das  GEM-Entwicklungspaket  (nur  fiir  IBM  PC) 


1 Einleitung 
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Die  Sprache  „C“  ist  Voraussetzung,  da  alle  Quellen  in  „C“  verfaBt  wurden.  Das  Lernen 
der  Sprache  konnen  wir  Ihnen  leider  nicht  beibringen.  Aber  es  gibt  bereits  unzahlige 
Bucher  zu  diesem  Thema,  z.B.: 

Mil  C zum  Ziel 
Arnold  Hickersberger 
Hiithig  Verlag 
ISBN  3-7785-1555-1 

Bin  Nachschlagewerk  ist  notwendig,  da  nicht  noch  einmal  alle  Funktionen  (ungefahr  200) 
erklart  werden  sollen.  Auch  Nachschlagewerke  gibt  es  vide.  Bin  Vorschlag  kdnnte  sein: 

Softwareentwicklung  auf  dem  Atari  ST,  2.Aufl. 

Jurgen  GeiB/Dieter  GeiB 
Hiithig  Verlag 
ISBN  3-7785-1533-0 

Im  Prinzip  konnen  Sie  den  C-Compiler  benutzen,  der  Ihnen  am  besten  gefallt.  Allerdings 
wurde  die  Lauffahigkeit  des  vorgestellten  Programms  nur  fur  folgende  Compiler  getestet: 

Auf  ATARI  ST  unter  GEMDOS: 

- Digital  Research  C (Alcyon  C) 

- Mark  Williams  C 

— Megamax  Laser  C 

— Lattice  C 

— Turbo  C 

Auf  IBM  PC  unter  MS-DOS: 

- Microsoft  C 

— Turbo  C 

Auf  386er  Rechnern  unter  FlexOS: 

- Metaware  High  C 

Leider  muBten  wir  feststellen,  daB  einige  Compiler  nicht  immer  korrekten  Code  erzeug- 
ten  Oder  wegen  anderer  Mangel  unbrauchbar  sind.  Genaueres  fmden  Sie  in  Kapitel  3. 

Wenn  Sie  Ihren  Lieblings-Compiler  gefunden  haben,  konnen  Sie  beruhigt  weiterlesen. 
Wenn  nicht,  sollten  Sie  uberlegen,  ob  Sie  auf  einen  anderen  Compiler  umsteigen  sollten. 
Es  ist  meistens  sehr  schwierig,  Fehler  des  Compilers  zu  finden. 

Entwicklen  Sie  unter  MS-DOS,  so  miissen  Sie  noch  das  Entwicklungspaket  von  Digital 
Research  erwerben,  Beim  Atari  sind  bei  alien  Compilern  die  GEM-Aufrufe  bereits  in  den 
Bibliotheken  enthalten.  Ein  Resource-Construction-Set  sollte  ebenfalls  erworben  werden. 
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Es  ist  bei  den  meisten  Compilern  aber  ebenfalls  Bestandteil  der  Entwicklungsumgebung. 
Welches  Projekt  erwartet  Sie  nun? 

Als  Beispielprogramm  haben  wir  eine  Applikation  vorgesehen,  die  ein  Klemmbrett  auf 
Diskette  verwaltet.  Dieses  Klemmbrett  soil  in  der  Lage  sein,  die  wichtigsten  Standard- 
formate  direkt  auszugeben.  Dazu  gehoren  normale  ASCII-Dateien,  GEM  Metafiles  und 
Bit-Image-Files.  Zusatzlich  sind  noch  einige  Demo-Optionen  in  das  Programm  eingebaut. 

Es  erwarten  Sie  auBer  den  schon  oben  genannten  noch  weitere  interessante  Themen,  die 
sogar  Profis  aufhorchen  lassen  muBten,  In  den  einzelnen  Kapiteln  wird  auf  Folgendes  ein- 
gegangen. 

Kapitel  2 beschaftigt  sich  mit  GEM.  Es  ist  vor  allem  fur  Anfanger  gedacht,  die  noch  kei- 
nen  tieferen  Einblick  in  die  GEM-Struktur  haben.  Es  behandelt  aber  auch  die  Implemen- 
tierung  der  verschiedenen  Versionen  und  beschaftigt  sich  mit  dem  Aufbau  der  Resourcen 
(Dialogboxen,  Menus  etc.).  Falls  Sie  Ihre  Resourcen  nur  auf  einem  Rechner  erstellen  und 
auf  einen  anderen  Rechner  iiberspielen  wollen,  mussen  Sie  diese  erst  konvertieren.  Dafiir 
wird  aber  ein  Programm  vorgestellt  werden,  das  diese  Konvertierung  automatisch  erle- 
digt.  Es  nennt  sich  GRC  (GEM  Resource  Converter). 

In  Kapitel  3 wird  auf  die  Entwicklungsumgebung  auf  verschiedenen  Rechnern  mit  den 
verschiedenen  Compilern  eingegangen.  Dort  werden  auch  Begriffe  wie  Portabilitat  und 
ANSI-C  erklart.  Sie  werden  erkennen,  warum  es  besser  ist,  mit  einem  ANSI-Compiler 
zu  arbeiten.  Es  wird  eine  Methode  vorgestellt,  wie  man  Header-Dateien  schreibt,  die  von 
ANSI  und  Nicht-ANSI-Compilern  verstanden  werden.  AuBerdem  soil  in  diesem  Kapitel 
der  MAKE-Mechanismus  erklart  werden.  Urspriinglich  aus  UNIX  kommend  greift  dieser 
Mechanismus  nun  auch  auf  PCs  immer  weiter  um  sich.  Anfangern  bietet  er  oft  Schwierig- 
keiten.  MAKE  unterstutzt  die  Software-Erstellung  groBerer  Projekte  ungemein. 

Erste  Programmierschritte  werden  in  Kapitel  4 getan.  Dieses  ist  vor  allem  fur  Anfanger 
gedacht. 

In  Kapitel  5 wird  es  zunachst  theoretisch.  Es  geht  um  die  Gestaltung  von  Benutzerober- 
flachen.  Warum  ist  ein  Programm  leichter  zu  bedienen  als  ein  anderes?  Gibt  es  Regeln 
fiir  die  Gestaltung  von  Oberflachen,  die  garantieren,  daB  ein  Programm  ubersichtlich  und 
leicht  bedienbar  wird?  Aus  benutzerpsychologischer  Sicht  wird  der  Mensch  vor  dem 
Rechner  betrachtet.  Welche  Aktionen  laufen  ab,  wenn  ein  Mensch  Menus  betrachtet  oder 
in  eine  Dialogbox  klickt?  Aus  der  Theorie  lassen  sich  zahlreiche  Folgerungen  fur  die  Pra- 
xis ableiten.  Dieses  Kapitel  wendet  sich  auch  an  den  fortgeschrittenen  Leser  und  setzt 
keine  Programmierkenntnisse  voraus.  Es  ist  daher  auch  fiir  diejenigen  gedacht,  die  nicht 
mit  „C“,  sondern  einer  anderen  Sprache  arbeiten. 

Ein  universelles  Modulkonzept  soil  in  Kapitel  6 erlautert  werden.  Es  zeigt,  wie  man  Mo- 
dule in  „C“  schreibt.  Dabei  hat  jedes  Modul  eine  spezifische  Aufgabe.  Der  groBe  Uber- 
hang,  der  in  GEM-Programmen  entsteht,  soil  vermieden  werden.  Warum  das  Rad  immer 


} Einleitung 


15 


neu  erfinden?  Hat  man  eine  Menge  von  Modulen,  so  kann  man  sich  dann  aus  diesen  sein 
Programm  zusammensetzen.  Verfechter  von  Modula  miissen  spatestens  nach  Lesen  die- 
ses Kapitels  zugeben,  dal?  modulate  Programmierung  auch  in  „C“  sehr  sauber  mdglich 
ist. 

Weiterhin  warden  alle  Module  des  Demoprogramms  erklart,  aber  nur  die  wichtigsten  auf- 
gelistet.  Es  wurden  Routinen  implemenentiert,  die  z.B.  Pop-Up-Meniis  oder  Meniizeilen 
in  Fenstern  mdglich  machen.  Auch  Accessories  diirfen  einen  eigenen  Desktop  haben. 
Dieser  wird  dann  in  ein  Fenster  gelegt.  Die  entsprechenden  Routinen  warden  jeweils  ge- 
nau  erlautert. 

Im  Anhang  warden  Header-Dateien  aufgelistet,  die  fiir  jeden  Compiler  und  jedes  Be- 
triebssystem  gleich  sind!  Dabei  wird  Portabilitat  groBgeschrieben.  Dazu  kommen 
Listings  der  Make-  bzw.  Projekt-Dateien. 

Noch  ein  Wort  zur  Einfiihrung:  Wurde  jeder  Software-Entwickler  nach  der  in  diesem 
Buch  beschriebenen  Methode  arbeiten,  konnte  der  Kaufer  der  Software  jederzeit  entschei- 
den,  in  welcher  Aufldsung  er  ein  Programm  bedienen  mdchte  und  ob  er  das  jeweilige 
Programm  als  Accessory  im  Hintergrund  Oder  als  Hauptprozell  im  Vordergrund  laufen 
lassen  mochte  (oder  beides).  An  der  Bedienung  wiirde  sich  praktisch  nichts  andern.  Damit 
ware  ein  Art  Multitasking  sogar  auf  dem  Atari  mdglich!  SchlieBIich  konnte  er  sich  ent- 
scheiden,  ob  er  das  Programm  lieber  zu  Hause  auf  einem  Atari  ST  oder  TT  einsetzen 
mdchte  oder  in  der  Firma  auf  einem  IBM  PC. 
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2 GEM  und  sein  Umfeld 


GEM  ist  die  Abkiirzung  fiir  ..Graphics  Environment  Manager"  Fur  alle  diejenigen  die 
es  falsch  aussprechen:  es  konimt  aus  dem  englischen  und  bedeutet  auch  Juwel.  woher  sich 
auch  das  GEM-Logo  ableitet.  Bei  GEM  handelt  sich  urn  ein  System,  das  die  Erstellung 
und  den  Ablauf  von  Software  mit  einer  modernen  Benutzerschnittstelle  ermoglicht.  Sol- 
che  Software  zeichnet  sich  dadurch  aus.  daB  die  Interaktion  mit  dem  Endbenutzer  iiber 
eine  sogenannte  grafische  Benutzeroberflache  stattfindet.  Merkmale  hiervon  sind  Maus- 
bedienung.  Pull-Down/Pop-Up-Meniis.  Bildschirm-Fenster  und  Piktogramme  (Icons). 

In  den  kommenden  Jahren  wird  die  Bedienung  von  Softwaresystemen  zunehmend  von 
diesen  Oberflachen  gepragt  werden.  Der  Grund  dafiir  liegt  in  der  schnelleren  Begreifbar- 
keit  und  der  einheitlichen  Bedienung  auch  verschiedener  Programme.  Der  Benutzer  kann 
sich  so  auf  das  Losen  seiner  Aufgabe  konzentrieren  und  nicht  darauf.  wie  er  sie  zu  bewal- 
tigen  hat. 

Auf  den  verschiedenen  Rechnertypen  haben  sich  einige  dieser  Systeme  herauskristalli- 
siert.  So  finden  wir  auf  dem  Apple  Macintosh  das  erste  kommerzielle  System  einer  grafi- 
schen  Benutzeroberflache.  Da  Apple  selbst  Forschung  in  dieser  Richtung  betreibt.  kann 
dieses  System  als  das  ausgereifteste  gelten. 

Auf  UNIX-Systemen  wird  sich  wahrscheinlich  ein  System  namens  X-Windows  durch- 
setzten.  Es  bietet  ebenfalls  eine  grafische  Benutzeroberflache  und  sogar  die  Moglichkeit 
mehrere  Prozesse  in  verschiedenen  Bildschirmfenstern  auf  dem  gleichen  Terminal  (Ser- 
ver) laufen  zu  lassen.  Programme  (Clients)  konnen  auf  der  anderen  Seite  der  Welt  gestar- 
tet  werden  und  die  Kontrolle  mittels  Nachrichten  iiber  das  Grafikterminal  iibernehmen. 
Man  nennt  dies  dementsprechend  Client-Server-Modell.  Der  Server  iibernimmt  hier  den 
gesamten  gerateabhangigen  Bildschirmaufbau.  Interessant  ist  in  diesem  Zusammenhang. 
daB  ATARI  mit  seiner  TT-Rechnerserie  UNIX  mit  X-Windows  ausliefern  wird.  Auch 
die  Transputer-Workstation  von  Atari  (ATW)  lauft  unter  dem  Betriebssystem  Helios  mit 
X-Windows. 

Auf  IBM-PCs  und  Kompatiblen  gibt  es  schon  seit  einigen  Jahren  GEM.  welches  von 
Digital  Research  entwickelt  wurde.  Doch  dazu  mehr  in  Kapitel  2.1.  Ein  anderes  System 
stammt  von  Microsoft,  dem  Marktfiihrer  der  Software- Entwicklungsschmiede.  Es  han- 
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delt  sich  um  MS-Windows,  das  aber  erst  in  den  letzten  Monaten  mehr  an  Bedeutung  ge- 
winnen  konnte.  Die  bisher  schwache  Verbreitung  liegt  zum  einen  an  Anfangsschwierig- 
keiten  bei  der  Auslieferung  der  ersten  Versionen  und  damit  einhergehend  dem  schwachen 
Software-Angebot,  das  MS-Windows  voll  ausschdpft.  Wahrscheinlich  wird  sich  dieses 
System  auf  IBM-PCs  und  Kompatiblen  durchsetzen,  da  Microsoft  „die  besten  Karten“ 
auf  diesen  Rechnern  hat. 

Anders  hingegen  sieht  es  bei  nichtkompatiblen  PCs  aus.  Dort  gibt  es  im  wesentlichen  nur 
noch  3 Typen.  Der  o.g.  Apple  Macintosh,  der  Commodore  Amiga  und  der  Atari  ST.  Der 
Amiga  bedient  sich  ebenfalls  einer  grafischen  Bernutzeroberflache,  die  Intuition  genannt 
wird.  Wer  sich  dafur  welter  interessiert,  sollte  in  entsprechender  Literatur  nachschlagen. 

Ubrig  bleibt  noch  der  ATARI  ST.  Die  Chefentwickler  bei  ATARI  entschieden  sich  fiir 
GEM,  das  die  einzige  grafische  Benutzeroberflache  war,  die  bereits  lauffahig  existierte 
und  nur  noch  vom  PC  auf  den  ATARI  portiert  werden  mulite.  Das  Betriebssystem  wurde 
selbst  entwickelt  und  bekam  den  Namen  TOS  (The  Operating  System),  das  sich  aus  dem 
BIOS,  dem  XBIOS,  dem  GEMDOS  sowie  dem  GEM  und  dem  Desktop  zusammensetzt. 
Diese  5 Teile  wurden  dann  auch  in  das  192  KByte  fassende  ROM  gebrannt. 

Wenn  vorhin  von  einheitlicher  Bedienung  auch  verschiedener  Programme  gesprochen 
wurde,  so  trifft  dies  nur  auf  den  Apple  Macintosh  zu.  Die  Firma  Apple  ist  die  einzige, 
die  Richtlinien  erlassen  hat,  an  die  sich  Software-Entwickler  zu  halten  haben.  So  sehen 
auch  Macintosh-Programme  immer  iihnlich  aus  und  sind  gleich  zu  bedienen.  Solche  Soft- 
ware kann  auch  unter  GEM  entwickelt  werden.  In  den  folgenden  Kapiteln  dieses  Buches 
wird  gezeigt,  wie  man  das  macht. 


2.1  Versionen 

Zur  Zeit  exisitieren  4 unterschiedliche  GEM-Versionen  (ohne  Nebenversionen).  Zu  er- 
wahnen  ist  vielleicht  noch  der  Vorganger  von  GEM.  Es  handelt  sich  um  das  GSX-System 
(Graphics  Extension),  welches  Grafikroutinen  zur  Verfugung  stellt,  auf  die  man  als  Pro- 
grammierer  zuriickgreifen  kann  und  die  die  Erstellung  von  Grafik-Applikationen  erleich- 
tern  sollten. 


2.1.1  GEM  l.X 

Diese  Version  ist  auf  PC’s  kaum  noch  anzutreffen,  da  sie  schon  sehr  alt  ist  und  durch 
neue  Versionen  ersetzt  wurde.  Dafur  hat  sie  aber  eine  andere  entscheidende  Bedeutung. 
Es  ist  die  Version,  die  im  TOS  des  ATARI  ST  seinen  Dienst  erledigt  und  das  ungefahr 
bei  300000  ATARI  ST  Kunden.  Diese  Version  wurde  seit  dem  ersten  ROM-Release 
kaum  weiterentwickelt.  Lediglich  einige  Bugs  wurden  behoben.  In  der  neuesten  TOS 
Version  1 .4  wurden  auch  einige  wenige  Funktionen  hinzugefiigt.  Sie  werden  im  Teil  VDI 
und  AES  beschrieben. 
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Abb.  2.1:  GEM  l.X  Desktop  (ATARI  ST) 


Ein  Vorteil  der  alien  Version  ist  die  Portierbarkeit.  Wird  GEM-Software  auf  einem 
ATARI  ST  entwickelt,  so  lauft  sie  auch  unter  neueren  GEM-Versionen,  wenn  man  sich 
an  die  Schnittstellen  halt.  Lediglich  die  GEM-Erweiterungen  des  TOS  1 .4  sind  nicht  mit 
GEM  2.X-Versionen  kompatibel.  Das  liegt  daran,  dali  das  TOS  1.4  von  ATARI  weiter- 
entwickelt  und  gepflegt  wird,  wahrend  die  Pflege  aller  anderen  GEM-Versionen  vom  Er- 
finder  Digital  Research  vorgenommen  wird. 

Ein  groBes  Manko  hat  allerdings  diese  GEM  Version.  Da  der  Platz  im  ROM  nicht  ausge- 
reicht  hat,  wurde  ein  wichtiger  Teil  des  OEM’s  ausgelagert.  Es  handelt  sich  um  das 
GDOS  (Graphics  Device  Operating  System).  Es  beinhaltet  die  gerateunabhangigen  Gra- 
fikfunktionen.  Sie  warden  auf  dem  ATARI  ST  nur  fur  den  Bildschirm  implementiert  und 
miissen  fur  Drucker,  Kamera,  Plotter  und  Metadateien  nachgeladen  werden.  Dabei  spielt 
die  Datei  ASSIGN. SYS  eine  entscheidende  Rolle.  Sie  wird  in  Kapitel  2.3  erklart. 

Das  Fehlen  des  GDOS  fiir  andere  Ausgabegerate  als  den  Bildschirm  (z.B.  Drucker,  Meta- 
dateien), sowie  des  Programmes  OUTPUT,  welches  grafische  Informationen  zu  Papier 
bringt,  hat  Schuld  daran,  daB  ATARI  Softwareprodukte  untereinander  kaum  Informatio- 
nen austauschen  konnen.  So  existieren  fiir  fast  jedes  Textprogramm  eigene  Druckertrei- 
ber  und  fiir  fast  jedes  Grafikprogramm  eigene  Grafikformate.  ATARI  hat  hier  den  ent- 
scheidenden  Fehler  gemacht  und  bei  der  Auslieferung  der  Entwicklungspakete  die  Stan- 
dardgrafikformate  von  GEM  (Meta-  und  Bit-Image-Dateien)  durch  das  Fehlen  des  GDOS 
und  des  OUTPUT-Programmes  nicht  unterstiitzt. 
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2.1.2  GEM  2.x 

Auf  IBM-PCs  und  kompatiblen  sind  die  Versionen  2.1  bzw.  2.2  am  haufigsten  vertreten. 
Dies  liegt  zum  einen  daran,  daB  sowohl  Schneider  als  auch  ATARI  mit  seinen  kompati- 
blen PCs  diese  Versionen  zur  Hardware  mit  ausliefern.  Zum  anderen  gibt  es  Software- 
Produkte  wie  ADIMENS  GT,  Superbase  usw.,  welche  ebenfalls  diese  Versionen  kosten- 
los  dem  Produkt  beifiigen.  Lizenzen  kosten  auBerdem  nur  I .-  DM  fiir  die  ersten  1000 
Stuck  pro  verkauftem  Produkt. 

Der  groBte  Unterschied  zwischen  den  Versionen  l.X  und  alien  weiteren  Versionen  ist 
die  Aufmachung  des  Desktops  (Schreibtisch).  Der  Desktop  ist  die  erste  GEM- 
Applikation,  die  beim  Starten  von  GEM  auf  dem  Bildschirm  erscheint.  Mit  ihm  kdnnen 
Dateien  einfach  kopiert  und  geloscht,  sowie  Programme  gestartet  werden. 


Abb.  2.2:  GEM  2.X  Desktop  (ATARI  ST/IBM  PC) 

Da  Digital  Research  einen  ProzeB  gegen  Apple  Computer  verier,  muBten  sie  das  Erschei- 
nungsbild  des  Desktop-Programms  andern,  Standen  in  der  Version  1 .X  noch  vier  frei  be- 
wegliche  Fenster  fiir  Dateimanipulationen  zur  Verfugung,  so  waren  es  ab  Version  2.X 
nur  noch  2 feste  Fenster.  Dies  veranlaBte  die  ATARI-Softwareentwickler  leider  zu  der 
Meinung,  daB  das  gesamte  GEM-System  nur  noch  2 feste  Fenster  verwalten  konne;  daB 
der  Desktop  nur  eine  Applikation  ist,  die  eben  nur  2 feste  Fenster  offnet,  mit  denen  man 
arbeiten  kann,  bemerkten  nur  die  wenigsten. 

Vielleicht  ist  dies  auch  ein  Grund,  warum  sich  die  GEM  Version  2.2  auf  dem  ATARI 
ST  nie  durchsetzen  konnte.  Angeboten  wird  sie  jedenfalls  von  der  Firma  ABC  Software 
zum  Preis  von  ca.  169.  - DM,  die  auch  die  Anpassung  der  Version  vom  PC  auf  den 
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ATARI  vornahm.  Einen  Vorteil  allerdings  besitzt  diese  ATARI-Version.  Das  GDOS  ist 
fester  Bestandteil  und  muB  nicht  zusatzlich  erst  noch  geladen  werden.  So  kann  Software 
von  einem  IBM  PC  ohne  Einschrankung  auf  einen  ATARI  ST  portiert  werden. 


2.1.3  GEM/3  bzw.  GEM  3.X 

Sei  ca.  Marz  ’87  existiert  die  GEM/3-Version.  Sie  wurde  so  erweitert,  daB  der  Ventura- 
Publisher  (ab  GEM  3.1 1),  ein  Desktop-Pubiishing-System  von  XEROX,  nun  ohne  spe- 
zielles  GEM  System  auskommt.  Beim  Ventura  Publisher  wurde  namlich  eine  spezielle 
GEM-Version  mitgeliefert,  da  die  Funktionalitat  der  GEM-2. X-Versionen  den  Fahig 
keiten  des  Publishers  nicht  Rechnung  tragen  konnte. 

Sonst  hat  sich  nicht  viel  geandert.  Zeichensatze  konnen  jetzt  dynamisch  in  Overlays  gela- 
den werden,  was  fiir  den  knappen  Speicher  bei  einer  MS-DOS-Maschine  mit  640  KByte 
wichtig  ist.  ATARI  ST  Besitzer  konnen  da  nur  lacheln,  da  Sie  bei  einem  MEGA  ST  4 
mit  4 Megabyte  Speicher  reichlich  Platz  fiir  GEM-Programme  haben. 

Auch  die  Installierung  (GEMPREP.BAT)  wurde  wesentlich  verbessert.  Man  kann  z.B. 
jetzt  mehrere  verschiedene  Druckertypen  gleichzeitig  benutzen  (OUTPUT  zeigt  diese  mit 
Namen  an).  So  konnte  man  Programmlistings  auf  einem  preiswerten  Nadeldrucker  ausge- 
ben,  wahrend  man  fiir  Publikationen  einen  Laserdrucker  benutzt. 


2.1.4  X/GEM 

X/GEM  ist  das,  wovonjeder  ATARI  ST  Besitzer  schon  immer  getraumt  hat.  Es  handelt 
sich  um  eine  GEM-Version,  die  auf  einem  Multiuser-Multitasking  Betriebssystem  imple- 
mentiert  wurde.  X/GEM  erlaubt  die  gleichzeitige  Abarbeitung  von  mehreren  Haupt- 
Applikationen  im  Vordergrund. 

Wahrend  GEM  nur  bedingt  multitaskingfahig  ist  (eine  Hauptapplikation,  mehrere  Acces- 
sories im  Hintergrund),  arbeitet  demgegeniiber  das  X/GEM  vollstandig  ohne  Accesso- 
ries. Man  starlet  einfach  all  diejenigen  Programme,  mit  denen  man  arbeiten  mochte,  und 
schaltet  zwischen  ihnen  hin  und  her,  indem  das  entsprechende  Fenster  mit  der  Maus  ange- 
wahlt  Oder  im  Programm-Menu  auf  der  rechten  Seite  der  Meniizeile  ein  Programm  ge- 
wahlt  wird.  Dies  wird  auf  einem  Apple  Macintosh  und  dem  Multifinder  genauso  gemacht. 

Die  X/GEM  Version  ist  zum  jetzigen  Zeitpunkt  (April  1989)  noch  nicht  ganz  fertig- 
gestellt.  Wenn  sie  aber  auf  dem  Markt  ist,  werden  die  Fahigkeiten  eines  INTEL  80386- 
oder  MC68030-Prozessors  zusammen  mit  einem  Multitasking-Betriebssystem  (z.B. 
FlexOS  von  Digital  Research)  voll  ausgeschopft  werden. 

Einige  ATARI  ST  Besitzer  werden  Jetzt  denken,  daB  dies  nur  ein  Traum  fiir  sie  bleiben 
wird.  Wir  konnen  aber  schon  heute  diesen  Traum  nahezu  vollstandig  verwirklichen,  und 
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zwar  mit  der  GEM  1 .X-Version  und  der  Hilfe  von  Accessories.  In  Kapitel  6 wird  dieses 
Konzept  genau  erklart.  Es  liegt  dann  nur  noch  an  Ihnen,  den  Software-Entwicklern,  in 
diese  aufregende  Welt  des  Multitasking  unter  GEM  einzusteigen.  Jeder  ernsthafte 
Software-Entwickler,  der  nicht  nur  vor  sich  her  programmieren  mochte,  sondern  zeigen 
will,  was  er  mit  Hilfe  von  GEM  leisten  kann,  kommt  nicht  umhin,  dieses  universelle  und 
ausgereifte  Konzept  zu  benutzen.  Portable  GEM-Applikationen  kdnnen  in  kiirzester  Zeit 
erstellt  werden. 


2.1.5  Zukiinftige  Versionen 

X/GEM  fur  FlexOS  ist  aber  immer  noch  nicht  das  Ende  der  GEM-Entwicklung.  Digital 
Research  hat  angekiindigt,  GEM  auch  fur  das  neue  Multitasking  Betriebssystem  OS/2 
von  Microsoft,  der  mit  dem  Presentation  Manager  ausgeliefert  wird,  zu  portieren,  Es 
wird  dann  keinen  GEM-Desktop  mehr  geben.  Vielmehr  wird  man  vom  DOS-Fenster  aus 
GEM-Programme  starten  kdnnen,  die  dann  in  einem  Fenster  des  Presentation-Manager 
ablaufen.  Vorhandene  GEM-Applikationen  miissen  lediglich  neu  ubersetzt  bzw,  gelinkt 
werden.  Sobald  diese  Version  verfiigbar  sein  wird,  werden  wir  unsere  Beispielapplikation 
daran  anpassen. 

Nur  sauber  geschriebene  GEM-Applikationen  werden  dann  ohne  Probleme  portierbar 
sein.  Auf  der  CeBit  ’89  konnte  man  schon  GEMDRAW  unter  OS/2  laufen  sehen.  Die 
gesamte  GEM-Applikation  lief  dort  in  einem  Fenster  des  Presentation  Managers.  Man 
konnte  dann  auch  OS/2-Programme  starten  und  zwischen  diesen  und  GEMDRAW  mit 
einem  Mausklick  umschalten.  Das  Ergebnis:  Unbegrenztes  Multitasking  ohne  Speicher- 
probleme. 

Damit  aber  noch  nicht  genug.  Auch  fiir  das  UNIX-Betriebssystem  soli  eine  Portierung 
gemacht  werden.  Wann  aber  damit  zu  rechnen  ist,  steht  in  den  Sternen. 

Wird  das  wahr,  was  Digital  Research  verspricht,  so  kdnnen  GEM-Applikationen  wie 
WORDPLUS  Oder  ADIMENS,  die  schon  heute  auf  mehreren  Rechnern  und  Betriebssy- 
stemen  lauffahig  sind  (und  sauber  programmiert  wurden! !),  kunftig  auch  unter  UNIX  und 
OS/2  ihre  Arbeit  verrichten.  Eine  einheitliche  Benutzerschnittstelle  auf  verschieden  Sy- 
stemen  kame  letztlich  jedem  Anwender  zugute.  Er  brauchte  dann  nicht  mehr  umzulernen, 
wenn  er  im  Biiro  an  einem  UNIX-Terminal  und  zu  Hause  z.B.  an  einem  PC  oder  ATARI 
ST  arbeitet.  Der  Software-Entwickler  schiiefllich  kdnnte  sein  Produkt  auf  verschieden- 
sten  Systemen  ohne  Mehraufwand  vermarkten. 


2.2  Struktur 

Be  vor  auf  die  beiden  wichtigsten  Teile  des  GEM  eingegangen  wird,  soil  die  Gesamtstruk- 
tur  erlautert  werden.  Besonders  fiir  den  Anfanger  ist  es  wichtig  sie  zu  verstehen,  damit 
er  sich  ein  Bild  vom  Zusammenspiel  der  einzelnen  Komponenten  machen  kann. 


2.2  Struktur 
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Abb.  2.3;  GEM-Systemzusammenhang  IBM 

Ganz  an  unterster  Stelle  steht  der  Rechner  mil  seiner  Hardware  (Drucker,  Harddisk/Flop- 
py, Tastatur,  Bildschirm,  Mans  etc).  Urn  die  Hardware  zu  steuern,  bedarf  es  eines  Be- 
triebssystems.  Dies  ist  bei  einem  IBM  PC  das  sogenannte  MS-DOS  oder  PC-DOS,  auf 
einem  ATARI  ST  das  TOS  (BIOS,  XBIOS  und  GEMDOS). 

Die  Funktionen  des  Betriebsystems  sind  Speicherverwaltung,  Steuern  der  Hardware  (z.B. 
Bildschirmausgabe),  Speicherung  von  Daten  auf  Massenspeicher,  Laden  und  Starten  von 
Programmen  usw.  Mit  Hilfe  des  Betriebsystems  ist  es  schon  mbglich,  Software  fiir  einen 
Rechner  zu  betreiben.  Dies  kann  eine  Textverarbeitung,  eine  Datenbank  oder  z.B.  eine 
Programmierumgebung  wie  Turbo  Pascal  sein.  Da  die  Ausgabe  solcher  Software  meist 
auf  einem  Bildschirm  stattfindet,  der  nicht  grafikfahig  ist,  nennen  wir  sie  alphanumeri- 
sche  Software. 
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Abb.  2.4:  Inhaltsverzeichnis  einer  Festplatte 
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Der  Bildschirm  wird  bei  alphanumerischer  Software  aufgeteilt  in  meist  80  Spalten  zu  25 
Zeilen.  Jedes  dieser  2000  Zeichen  auf  dem  Schirm  kann  einzeln  gesetzt  werden.  Dabei 
kann  das  Zeichen  einen  Wert  zwischen  0 und  255  besitzen,  was  dem  ASCII-Code  gleich- 
kommt.  Das  entsprechende  Zeichen  (z.B.  ’A’ =65)  erscheint  an  der  gewiinschten  Bild- 
schirmposition. 

Wie  man  sich  leicht  ausrechnen  kann,  siiid  die  Moglichkeiten,  2000  Zeichen  beliebig  auf 
dem  Bildschirm  zu  setzen,  nicht  gerade  berauschend.  Selbst  mit  sogenannten  Grafik- 
symbolen  sind  allenfalls  Tabeilen  und  einfache  Strichzeichnungen  zu  bewerkstelligen, 

Um  dieses  Manko  zu  beheben,  wurden  Grafikkarten  (IBM  PC)  eingefuhrt,  bei  denen  je- 
der  einzelne  Punkt,  aus  dem  ein  Zeichen  zusammengesetzt  ist,  an  oder  ausgeschaltet  wer- 
den kann.  Ein  ATARI  ST  besitzt  erst  gar  keinen  speziellen  Textbildschirm,  er  wird  gleich 
mit  einer  hochauflosenden  Grafik  ausgeliefert. 

Besteht  ein  Zeichen  z.B,  aus  einer  8x16  Punktmatrix,  so  ergeben  sich  bei  80  Zeichen  zu 
25  Zeilen  immerhin  640x400  Bildpunkte,  die  einzeln  an  oder  ausgeschaltet  werden  kon- 
nen.  Dies  ist  eine  Steigerung  der  2000  Zeichen  aus  dem  Beispiel  von  oben  auf  256000 
Bildpunkte,  also  dem  128-fachen. 

Wahrend  man  mit  einfachen  Betriebssystemfunktionen  noch  Zeichen  auf  dem  Bildschirm 
ausgeben  konnte,  wie  z.B.  printf  (’’Hallo”),  so  versagen  diese  Ausgabefunktionen  bei  ei- 
ner Grafikkarte  ganzlich,  da  das  Betriebssystem  bei  seiner  Entwicklung  nicht  vorhersehen 
konnte,  welche  Grafikkarten  einmal  fiir  einen  Rechner  entwickelt  werden  wurden. 

Mdchte  man  aber  Software  entwickeln,  die  diese  Grafik  benutzt,  so  mufi  entweder  das 
Betriebssystem  erweitert  werden,  oder  man  mull  selbst  die  Grafikkarte  iiber  Hardware- 
adressen  ansprechen  und  programmieren.  Dieser  Aufwand  ist  nicht  nur  unvertretbar 
hoch,  auch  Programme,  die  mit  der  einen  Grafikkarte  der  Firma  X laufen,  versagen  bei 
einer  Karte  der  Firma  Y den  Dienst. 

Dieses  Problem  haben  Entwickler  von  Betriebsystemen  erkannt  und  bieten  zur  ihren  Sy- 
stemen  Grafikerweitwerungen  an.  Dabei  handelt  es  sich  um  ein  Softwarepaket,  das  resi- 
dent in  den  Speicher  geladen  wird  und  welches  iiber  genormte  Softwareschnittstellen  an- 
gesprochen  werden  kann.  Meistens  sind  dies  Funktionen,  die  von  einer  hoheren  Proram- 
miersprache  aus  (Pascal  oder  C)  aufgerufen  werden  konnen. 

Der  Teil,  der  diese  Grafikerweiterungen  enthalt,  ist  im  GEM-System  das  VDI  (Virtual 
Device  Interface).  Es  enthalt  eine  Menge  von  harwareunabhangigen  Grafikfunktionen, 
die  in  jedes  Programm  mit  eingebunden  werden  konnen.  Da  das  VDIje  nach  Grafikkarte 
und  Rechner  bzw.  Betriebssystem  verschieden  installiert  wird  und  sich  so  der  Hardware 
anpasst,  erhoht  die  Verwendung  dieser  Funktionen  in  eigenen  Programmen  die  Porta- 
bilitat. 

Moderne  Software  zeichnet  sich  aber  nicht  nur  dutch  die  Benutzung  von  hochauflosenden 
Rasterbildschirmen  aus,  sondern  auch  dutch  die  Verwendung  von  Bildschirmfenstern, 
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Pull-Down-Meniis,  Piktogrammen  und  einer  Maus. 

Die  ganze  Verwaltung  der  Bildschirmfenster,  Menus  und  Dialogboxen  iibernimmt  ein  zu- 
siitzlicher  Teil  des  GEM,  namlich  das  AES  (Application  Environment  Services).  Es  be- 
nutzt  VDI-Funktionen,  um  z.B.  ein  Bildschirmfenster  oder  eine  Dialogbox  zu  zeichnen 
Oder  ganze  Fenster  zu  verschieben.  Es  setzt  also  groBtenteils  auf  dem  VDI  auf. 

Ein  Anwendungsprogramm  oder  eine  Applikation  benutzt  also  AES-Funktionen,  wenn 
es  Fenster  erzeugen,  Dialogboxen  benutzen  oder  Maus-  und  Tastatureingaben  machen 
mdchte.  Fiir  die  gerateunabhangige  Grafikausgabe  wird  man  VDI-Funktionen  benutzen, 
wahrend  man  fiir  die  Speicherung  und  das  Laden  von  Daten  auf  die  gewohnten  Betriebs- 
systemfunktionen  zuriickgreift. 

Die  Vorteile  liegen  klar  auf  der  Hand.  Die  riesige  Sammlung  von  Grafik-  und  Fensterrou- 
tinen  erleichtern  die  Entwicklung  moderner  Software.  Der  Programmierer  mull  sich  nicht 
mehr  mit  hardwareabhangigen  Ausgabefunktionen  herumschlagen,  sondern  kann  sich  auf 
seine  Aufgabe  konzentrieren.  Und  die  Software  ist,  vorausgesetzt  er  halt  sich  an  die 
Schnittstellen  des  GEM-Systems,  von  einem  Rechner  auf  den  anderen  portabel.  Voile 
GEM-Portabilitat  von  GEM  1.x  bis  X/GEM  wird  in  Kapitel  6 erlautert. 


2.3  VDI 

Das  Virtual  Decive  Interface  (VDI)  des  GEM  stellt  dem  Programmierer  eine  Menge  von 
gerateunabhangigen  Aus-  und  Eingabe-Funktionen  zur  Verfiigung.  Dabei  spielt  es  nor- 
malerweise  keine  Rolle,  ob  z.B.  Ausgaben  auf  den  Bildschirm,  den  Drucker  oder  einen 
Plotter  gemacht  werden.  Die  Aufrufsequenzen  sind  praktisch  identisch. 

Leider  bestehen,  wie  schon  oben  erwahnt,  bei  einem  ATARI  ST  diese  Mdglichkeiten 
nicht,  da  die  Teile  des  GDOS,  die  nicht  fiir  die  Bildschirmausgabe  bestimmt  sind  (Treiber 
und  Zeichensatze  fiir  Plotter,  Drucker,  Metadateien,  Kamera,  Grafiktablett)  keinen  Platz 
mehr  im  ROM  hatten.  Da  die  GDOS-Erweiterungen  zwar  nachgeladen  werden  konnen 
(GDOS.PRG  im  Auto-Ordner),  aber  standardmaBig  nicht  mitgeliefert  werden,  konnte 
sich  das  GEM-Ausgabeformat  (Bit-Image-  und  Metadatei-Format)  noch  nicht  auf  dem 
ATARI  ST  durchsetzen.  Inzwischen  gibt  es  aber  gliicklicherweise  ein  neues  GDOS,  das 
von  Arndt  BeiBner  entwickelt  wurde  und  bei  ATARI  Deutschland  GmbH  erhaltlich  ist. 
Es  zeichnet  sich  vor  allem  durch  eine  hohe  Arbeitsgeschwindigkeit  aus,  wahrend  das  alte 
Original-ATARI-GDOS  den  Bildschirmaufbau  wesentlich  bremste. 


2.3.1  Koordinatensysteme 

Grundsatzlich  bietet  das  VDI  2 Moglichkeiten  an,  Grafik  auf  einem  Ausgabegerat  zu  er 
zeugen. 
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Durch  Benutzung  von 

a)  Normalized  Device  Coordinates  (NDC) 

b)  Raster  Coordinates  (RC) 


•, 32767 


32767.  0 


6, 0 x-1. a 


Abb.  2.5:  NDC  und  RC-Koordinatensysteme 


Die  normalisierten  Geratekoordinaten  (NDC)  zeichnen  sich  dadurch  aus,  dal)  der  Koordi- 
natenursprung  in  der  linken  unteren  Ecke  liegt  (0,0)  und  auf  beiden  Achsen  die  x-  bzw. 
y-Werte  bis  32767  reichen  konnen. 

Rasterkoordinaten  (RC)  haben  ihren  Ursprung  in  der  linken  oberen  Ecke,  und  die  Koordi- 
naten  wachsen  nach  rechts  bzw.  nach  unten.  Rasterkoordinaten  sind  bei  einem  Bildschirm 
z.B.  640  X 400  Punkte  in  x-  bzw.  y-Richtung.  Fiir  die  Ausgabe  in  einem  Bildschirmfen- 
ster  wird  man  immer  Rasterkoordinaten  wahlen,  da  das  Fensterinnere  seinen  Ursprung 
in  der  linken  oberen  Ecke  besitzt  und  nach  rechts  unten  groBer  wird. 

Ein  Quadrat  mit  der  Kantenlange  16384  in  NDC-Koordinaten  ware  auf  einem  Bildschirm 
von  640  x 400  Punkten  ein  Rechteck  mit  300x200  Punkten. 

Das  bedeutet,  daB  das  Ausgabegerat  als  quadratisch  angesehen  wird.  1st  es  nicht  physika- 
lisch  quadratisch,  wie  in  unserem  Bildschirmbeispiel,  so  iibernimmt  das  GDOS  die  Trans- 
formation von  NDC-  in  RC-Koordinaten,  bevor  die  Ausgabe  an  den  Treiber  geht,  der 
die  Grafik  auf  dem  Bildschirm  darstellt. 

Benutzt  man  nur  Raster-Koordinaten,  so  wird  vom  GDOS  keine  Transformation  vorge- 
nommen.  Die  Ausgabe  der  Rasterpunkte  (auch  eine  Linie  besteht  nur  aus  einzelnen  Punk- 
ten) erfolgt  direkt  auf  dem  Ausgabegerat.  Diese  Methode  ist  wesentlich  schneller  und 
sollte  der  NDC-Methode  vorgezogen  werden. 


2.3  VDl 
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2.3.2  Aufbau  des  VDI 

Das  VDI  besteht  aus  3 logischen  Komponenten: 

- Graphics  Device  Operatingsystem  (GDOS) 

- Geratetreiber 

- Zeichensatze 

a)  Graphics  Device  Operating  System 

Das  GDOS  beinhaltet  alle  gerateunabhangigen  Grafikfunktionen.  Diese  Funktionen  kon- 
nen  z.B.  iiber  Aufrufe  in  C,  Pascal  oder  Modula  benutzt,  werden.  Falls  normalisierte 
Koordinaten  (NDC)  benutzt  werden  (siehe  2.3.1),  ubernimmt  das  GDOS  die  Umrech- 
nung  in  die  geratespezifischen  Rasterkoordinaten. 

b)  Geratetreiber 

Ein  Geratetreiber  ist  ein  Programm,  das  aus  einer  gegebenen  Eingabe  (z.B.  „Zeichne  Li- 
nie  von  Punkt  3,3  nach  50,30“)  ein  physikalisches  Gerat  wie  Bildschirm  oder  Drucker 
anspricht  und  dort  die  Eingabe  sichtbar  macht.  Dabei  kennt  der  Treiber  die  physikali- 
schen  Gegebenheiten  eines  Geriits  und  kann  es  optimal  ansteuern. 

So  kann  auf  einem  Laserdrucker  die  geforderte  Linie  mit  einer  Auflosung  von  300  X 300 
dpi  (dots  per  inch  = Punkte  pro  Zoll)  dargestellt  werden,  wahrend  der  Treiber  eines  Ma 
trixdruckers  nur  eine  Auflosung  von  vielleicht  240x216  dpi  zu  Papier  bringen  kann. 
Darauf  beruht  die  Idee  des  VDI,  die  Qualitat  eines  Ausgabegerates  durch  entsprechende 
Treiber  voll  auszunutzen.  Dies  ist  in  GEM  aber  nur  moglich,  wenn  Ausgaben  iiber  das 
sogenannte  OUTPUT-Programm  gemacht  werden,  welches  ASCII-Texte,  Metadateien 
und  Bit-Image-Dateien  mit  der  bestmoglichen  Qualitat  zu  Papier  bringen  kann. 

c)  Zeichensatze 

Zu  jedem  Ausgabegerat  gibt  es  noch  eine  Anzahl  von  Zeichensatzen,  die  installiert  wer- 
den konnen.  Die  Zeichensatze  sind  so  aufgebaut,  da6  das  Verhaltnis  von  Grafik-  und 
Textausgaben  auf  alien  Geraten  konstant  ist.  Sie  befinden  sich  ats  externe  Dateien  (z.B. 
IBMHSS36.FNT)  auf  dem  Massenspeicher. 

Der  Treiber  fiir  den  Bildschirm  enthalt  standardmaBig  einen  sogenannten  System- 
Zeichensatz  (Nummer  1),  der  immer  vorhanden  ist.  Er  wird  auch  benutzt,  um  z.B.  die 
Menuzeile  anzuzeigen.  Dieser  Zeichensatz  ist  meist  in  2 (IBM-PC)  oder  3 (ATARI  ST) 
PunktgroBen  vorhanden.  Die  kleinste  GroBe  ist  u.a.  fiir  Piktogrammbeschriftungen  vor- 
gesehen. 

Zusatzliche  Zeichensatze  konnen  iiber  eine  VDI-Funktion  jederzeit  nachgeladen  werden. 
Bei  einem  ATARI  ST  ist  dies  nur  moglich,  wenn  das  Programm  GDOS.PRG  installiert 
wurde.  Welche  und  wieviele  Zeichensatze  zu  einem  Treiber  gehoren,  kann  man  der  Datei 
ASSIGN. SYS  entnehmen.  Sie  wird  weiter  unten  erkliirt. 
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2.3.3  VDI-Funktionsgruppen 

Bevor  ubersichtsartig  auf  die  Funktionsgruppen  eingegangen  wird,  sollen  noch  einige  Be- 
griffe  erlautert  werden: 

— Arbeitsstation  (workstation) 

— Geriitekennung  (device  handle) 

— Attribute 

Eine  Arbeitsstation  ist  ein  allgemeiner  Begriff  fiir  ein  Ein-  oder  Ausgabegerat.  Wie  schon 
weiter  oben  erwahnt,  konnen  Arbeitsstationen  Bildschirme,  Drucker,  Plotter,  Kameras, 
Grafiktabletts  usw.  sein.  Eine  spezielle  Art  der  Arbeitsstation  sind  die  sogenannten  Meta- 
dateien.  Sie  sind  zwar  keine  physikalischen  Gerate,  werden  aber  genauso  gehandhabt. 
Die  Grafikausgabe  wird  in  diesem  Fall  auf  eine  Datei  (mit  Suffix  .GEM)  statt  z.B.  auf 
einen  Drucker  geleitet.  So  kann  diese  Datei  auch  als  Eingabe  zum  Datenaustausch  dienen. 

Das  VDI  erlaubt  es,  daB  mehr  als  eine  Arbeitsstation  gleichzeitig  von  einem  Programm 
genutzt  wird.  So  kann  man  Ausgaben  auf  einen  Plotter  leiten  und  die  Tastatur  abfragen, 
ob  die  Ausgabe  unterbrochen  werden  soli.  Die  Ausgabe  geht  dann  auf  die  Arbeitsstation 
Plotter,  wahrend  die  Eingabe  von  den  Arbeitsstationen  Bildschirm,  Tastatur  oder  Maus 
kommt.  Die  Arbeitsstationen  Bildschirm,  Tastatur  und  Maus  werden  immer  als  eine  Ein- 
heit  gesehen. 

Es  konnen  auch  gleichzeitig  Ausgaben  auf  mehreren  Geraten  stattfinden.  Die  Funktions- 
aufrufe  sind  aber  die  gleichen  (wie  v__gtext  = vdi  graphics  text).  Wird  z.B.  Text  auf 
Drucker  und  Bildschirm  ausgegeben,  so  muB  das  VDI  wissen,  welches  Geriit  gemeint 
ist.  Zu  diesem  Zweck  ubergibt  man  der  Aus-  oder  Eingabefunktion  eine  Geratekennung 
(handle).  Es  handelt  sich  urn  eine  Zahl  grofier  gleich  1.  Damit  entscheidet  letztendlich 
das  GDOS,  zu  welcher  Arbeitsstation  die  gewiinschte  Funktion  geleitet  werden  soil.  Eine 
Geratekennung  erhalt  man  beim  Anmelden  einer  Arbeitsstation.  Die  Funktion  v_opnwk 
(vdi  open  workstation)  ist  in  diesem  Zusammenhang  entscheidend. 

Jedes  Gerat  kennt  2 Satze  von  Attributen.  Die  geratespezifischen  Attribute  teilen  dem  Be- 
nutzer  mit,  wie  das  Aus-  oder  Eingabegerat  beschaffen  ist  und  welche  Eigenschaften  es 
hat.  Zu  diesen  Eigenschaften  zahlen  u.a.  Anzaht  der  verfugbaren  Farben,  PixelgroBe  so- 
wie  Breite  und  Hohe  des  Ausgabebereiches.  Diese  Attribute  sind  fiir  jedes  Ausgabegerat 
fest  und  konnen  natiirlich  nicht  verandert  werden. 

AuBerdem  existieren  noch  die  sogenannten  Ausgabe-Attribute.  Mit  ihnen  kann  u.a.  die 
Strichdicke,  die  Farbe  von  Mustern  und  der  Zeichensatz  eingestellt  werden,  mit  dem  die 
Ausgabe  erfolgen  soil.  Diese  Attribute  lassen  sich  dynamisch  zur  Laufzeit  andern. 


Die  Funktionen  des  VDI  kann  man  in  7 Gruppen  aufteilen: 


— Kontroll-Funktionen 


2.J  VDI 
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Mit  Hilfe  der  Open-Workstation-Funktion  konnen  Ausgabegerate  zum  spateren  Gebrauch 
geoffnet  werden.  Man  bekommt  die  Geratekennung  (device  handle)  zuriick,  mit  der  man 
alle  nachfolgenden  VDFAufrufe  fiir  dieses  Geriit  tatigen  muB.  Das  GDOS  kann  dann  den 
entsprechenden  Ausgabetreiber  aufrufen. 

Fiir  den  Bildschirm  gelten  besondere  Regeln.  Es  ist  erlaubt,  daB  mehrere  Applikationen 
gleichzeitig  auf  das  physikalische  Medium  Bildschirm  zugreifen.  Beim  Initialisieren  des 
GEM  iibernimmt  es  selbst  die  Offnung  des  physikalischen  Ausgabegerates  Bildschirm  mit 
der  Funktion  Open-Workstation  (Geratekennung  1).  Jede  GEM-Applikation  hat  dann  die 
Mdglichkeit,  den  Bildschirm  als  virtuelles  Ausgabegerat  zu  offnen.  Dabei  bekommt  jede 
GEM-Applikation  (Programm  oder  Desk  Accessory)  uber  seine  virtuelle  Geratekennung 
einen  Satz  von  Bildschirmattributen  zugeordnet,  die  man  individuell  einstellen  kann, 

Wahlt  z.B.  ein  Programm  die  Farbe  Rot  fiir  seine  Textausgabe,  ein  Accessory  aber  die 
Farbe  Griin  und  Kursivschrift,  so  sind  in  jeder  der  beiden  Umgebungen  die  entsprechen- 
den Attribute  gesetzt.  Es  konnen  Ausgaben  vom  Programm  oder  Accessory  folgen,  wobei 
das  VDI  die  Texte  entweder  rot  oder  griin  und  kursiv  auf  den  Bildschirm  bringt.  Die  bei- 
den Applikationen  brauchen  die  Ausgabeattribute  also  nur  zu  Beginn  des  Programmlaufs 
einstellen.  Sie  bleiben  individuell  erhalten. 

Beim  Offnen  der  Arbeitsstation  wird  auBerdem  der  entsprechende  Treiber  geladen,  der 
fiir  die  Ausgabe  auf  dem  angegebenen  physikalischen  Medium  zustandig  ist.  Den  Namen 
des  Treibers  erfahrt  das  System  aus  der  Datei  ASSIGN. SYS  (bis  GEM  2.X)  bzw.  aus 
dem  Ordner  \GEMAPPS\GEMSYS\  (ab  GEM/3). 

Weitere  Funktionen  sind  fiir  das  Loschen  und  Aktualisieren  der  Arbeitsstation  sowie  fiir 
das  Laden  und  Freigeben  von  Zeichensatzen  zustandig. 


- Ausgabe-Funktionen 

Sie  gehoren  zu  den  am  meisten  verwendeten  Funtionen,  da  Applikationen  ohne  Ausgabe 
sehr  selten  einem  Zweck  dienen.  Zu  den  Ausgabefunktionen  gehoren  Linien,  Strecken- 
ziige,  Text,  gefullte  Streckenziige,  Rechtecke,  Kreise,  Kuchenstucke  (pie  slice),  Ellipsen, 
Kreisbogen,  ausgerichtete  Texte  und  mehr. 


— Attribute-Funktionen 

Bei  den  Ausgabefunktionen  ist  es  mbglich,  gewisse  Attribute  auszuwahlen.  So  konnen 
bei  einer  Linie  die  Strichdicke,  die  Farbe,  die  Enden  der  Linie  (z.B.  ein  Pfeil  auf  einer 
Seite)  usw.  eingestellt  werden.  Bei  gefullten  Flachen  konnen  u.a.  das  Fiillmuster,  die 
Fiillfarbe  und  weitere  Attribute  eingestellt  werden.  Wie  oben  erwiihnt,  behalten  die  Attri- 
bute fiir  ein  und  dieselbe  Arbeitsstation  ihre  Giiltigkeit,  bis  das  Programm  terminiert  oder 
die  Attribute  anders  eingestellt  werden. 
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— Raster-Funktionen 

Mit  Hilfe  der  Raster-Funktionen  konnen  rechteckige  Blocke  von  Punkten  manipuliert 
werden.  So  konnen  z.B.  ganze  Blocke  kopiert  und  vom  Speicher  in  den  Bildschirm  uber- 
tragen  werden.  Dabei  konnen  logische  Operationen  bei  der  Anwendung  benutzt  werden. 
Es  konnen  auch  Bildschirmbereiche  gescrollt  werden,  wenn  als  Quelle  und  Ziel  der  Ope- 
ration der  Bildschirm  gewahlt  wird.  Dies  ist  eine  der  wichtigsten  Anwendungen,  wenn 
man  an  Bildschirmfenster  denkt,  die  z.B.  bei  einer  Textverarbeitung  benutzt  werden. 

Raster-Funktionen  haben  aber  noch  eine  andere  wichtige  Bedeutung,  die  bei  ATARI  ST- 
Programmierern  haufig  vernachlassigt  wird.  Es  konnen  auch  Pixel-Bldcke  vom  Standard- 
format  in  das  geriitespezifische  Format  umgewandelt  werden.  Versucht  man  ein  ATARI 
ST  GEM-Programm  auf  einen  IBM-PC  zu  portieren,  so  wird  man  sich  wundern,  wenn 
z.B.  Piktogramme  gezeichnet  werden  sollen.  Sie  erscheinen  je  nach  Grafikkarte  mehr 
Oder  weniger  verstiimmelt.  Die  Bedeutung  und  Wirkungsweise  der  Transformation  wird 
bei  der  Funktion  TRANSFORM  FORM  in  Kapitel  2.3.7  genau  erkliirt. 


— Eingabe-Funktionen 

Die  Eingabe-Funktionen  erlauben  die  Eingabe  mit  der  Maus,  den  Funktionstasten  und 
von  Zeichen  der  Tastatur.  Allerdings  muB  ausdrucklich  darauf  hingewiesen  werden,  dal5 
diese  Funktionen  in  GEM-Programmen  nicht  benutzt  werden  sollten  Oder  besser  diirfen. 
Nur  in  reinen  VDI-Programmen  funktionieren  sie  so,  wie  sie  eigentlich  sollen.  Da  sie 
fiir  GEM-Programme  also  nicht  wichtig  sind,  sollen  sie  auch  nicht  ausfiihrlich  behandelt 
werden. 

Nur  soviel  sei  gesagt:  Man  kann  die  Funktionen  im  Sample-  und  Request-Modus  aufru- 
fen.  Im  Sample-Modus  kehrt  die  Funktion  sofort  zurixck  und  gibt  den  Status  und  eventuell 
Daten  an  den  Aufrufer  zuriick.  Im  Request-Modus  wartet  die  Funktion  so  lange,  bis  ein 
Ereignis  aufgetreten  ist  (z.B.  eine  Zeichenkette  eingegeben  wurde). 


— Nachfrage-Funktionen 

Mit  ihnen  ist  es  moglich,  die  eingestellten  Attribute  aus  den  Attribute-Funktionen  zu  er- 
fragen.  Auch  Informationen  iiber  Zeichensatze  werden  angeliefert.  Die  erweiterte 
Abfrage-Funktion  vq^extnd  liefert  weitere  Informationen  iiber  das  gewiinschte  Ausga- 
begerat. 


— Escape-Funktionen 

Einige  spezielle  Eigenschaften  eines  Ausgabegerates  konnen  hiermit  gesteuert  werden. 
Enter  anderem  kann  eine  Hardcopy  des  Bildschirms  auf  ein  Gerat  ausgegeben  werden. 
Auch  die  Steuerung  des  alphanumerischen  Bildschirms  erfolgt  iiber  Escape-Funktionen. 


Bei  einem  ATARI  ST  ist  der  alphanumerische  Bildschirm  gleich  dem  Grafikschirm,  bei 
IBM  PC’s  und  Kompatiblen  existieren  meist  2 getrennte  Bildschirme:  Der,  den  man  beim 
Einschalten  des  Rechners  zu  sehen  bekommt  (DOS  Prompt),  und  derjenige,  der  beim 
Start  von  GEM  und  anderen  grafikorientierten  Programmen  erscheint. 


2.3.4  ASSIGN.SYS 

Wie  schon  oben  erwahnt,  findet  man  bis  GEM  2.X  eine  Datei  namens  ASSIGN.SYS. 
Sie  wird  dazu  benotigt,  Geratetreiber  und  deren  Zeichensatze  festzulegen.  Beim  Installie 
ren  des  GEM  auf  einem  IBM  PC  werden  die  einzelnen  Gerate,  die  angeschlossen  werden 
sollen,  abgefragt  und  die  Datei  ASSIGN.SYS  entsprechend  aufgebaut.  Auf  einem  ATARI 
ST  wird  diese  Datei  von  verschiedenen  Desktop-Publishing-Systemen  und  objektorien- 
tierten  Zeichenprogrammen  mitgeliefert. 

Wird  das  GEM  gestartet,  so  untersucht  das  GDOS,  das  sich  bei  einem  ATARI  ST  meist 
im  AUTO-Ordner  befindet,  die  Datei  ASSIGN.SYS  und  baut  im  Speicher  eine  Zuwei- 
sungstabelle  auf.  Zu  jeder  angegebenen  Geratenummer  wird  der  Name  und  die  eindeutige 
Geratenummer  des  Treibers  und  die  Namen  der  fur  dieses  Geriit  verfiigbaren  zusatzlichen 
Zeichensatze  in  einer  Tabelle  gespeichert. 

Offnet  man  ein  Ausgabegerat  mit  einer  der  verfiigbaren  Geratenummern  (iiber  die  Funk- 
tion  v_opnwk),  so  referiert  das  GDOS  die  Zuweisungstabelle  und  ladt  den  Treiber  fiir 
dieses  Ausgabegerat  in  den  Hauptspeicher.  Der  Treiber  liegt  nun  vor,  und  alle  VDI- 
Aufrufe  mit  der  Geratekennung  (device  handle)  fur  diesen  Treiber  werden  von  ihm  auf 
das  Ausgabegerat  gebracht. 

Entsprechendes  gilt  fur  den  VDI-Befehl  vst_Ioad_fonts.  Das  GDOS  schaut  in  der 
Tabelle  nach  und  ladt  alle  Zeichensatze  fiir  das  angegebene  Ausgabegerat. 

Die  Datei  ASSIGN.SYS  ist  eine  Textdatei  und  kann  somit  leicht  eingesehen  bzw.  editiert 
werden.  Ihr  Aufbau  wird  im  Folgenden  beschrieben: 

< Geratenummer  I>  < Option  > <Dateiname  des  Treibers  > <Kommentar> 

< Zeichensatz  1 > 

<Zeichensatz  2> 

< Geratenummer  2>  ... 

usw. 

- Geratenummern 

Die  Geratenummern  hangen  eng  mit  dem  Geriitetyp  zusammen.  So  sind  fiir  jeden  Typ 
10  Nummern  vorgesehen. 
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Geratenummer 


Geratetyp 


01 

- 10 

Bildschirm 

11 

- 20 

Plotter 

21 

- 30 

Drucker 

31 

- 40 

Metadatei 

41 

- 50 

Kamera 

51 

- 60 

Grafiktablett 

Hinter  der  Geratenummer  konnen  noch  2 Optionen  angegeben  werden.  Ein  ’r’  bedeutet, 
daB  der  Treiber  schon  beim  Untersuchen  der  Datei  ASSIGN. SYS  durch  das  GDOS  gela- 
den  wird  und  resident  im  Speicher  bleibt.  Offnet  man  die  Arbeitsstation,  so  braucht  der 
Treiber  nicht  erst  nachgeladen  werden.  Allerdings  kostet  das  einiges  an  Speicher.  Ein 
einziger  Treiber  verbraucht  zwischen  5 KByte  (Metadatei)  und  70  KByte  (Lasertreiber). 

Auf  dem  ATARI  ST  kann  die  Option  noch  den  Buchstaben  ’p’  annehmen.  Dies  bedeutet, 
daB  sich  der  Treiber  permanent  im  ROM  befindet,  also  nicht  geladen  werden  muB.  Dies 
ist  fiir  den  Bildschirmtreiber  der  Fall. 

Die  Dateinamen  der  Treiber  mussen  mit  einem  Buchstaben  beginnen  und  enden  mit  dem 
Suffix  „.SYS“.  Kommentare  werden  mit  einem  Semikolon  eingeleitet. 


Beispiele: 

Olp  SCREEN. SYS;  Bildschirmtreiber,  der  sich  im  ROM  befindet 
21  FX80.SYS  ; Druckertreiber  (21)  mit  Dateinamen  FX80.SYS 
31r  META. SYS  ; Metadatei-Treiber,  der  resident  im  Speicher  bleibt 


Zwei  Beispiele  sollen  den  Gesamtaufbau  verdeutlichen: 

a)  ASSISGN.SYS  auf  einem  IBM  PC  mit  Hercules-Grafikkarte 

01  HERM0NP6;  Hercules  Karte  / Monochrom-PC-Bildschirm  (720x348) 
; Serielle  Maus  von  Microsoft  ( RS232  ) 

; Kommunlkatlonsschnittstelle  Nr.  1 (COMl:) 

IBMHSS07.FNT;  Hercules  Swiss  7 Punkt 

IBMHSSIO . FNT ; Hercules  Swiss  10  Punkt 

IBMHSS14.FNT;  Hercules  Swiss  l4  Punkt 

IBMHSS18.FNT;  Hercules  Swiss  18  Punkt 

IBMHSS36.FNT;  Hercules  Swiss  36  Punkt 

IBMHTR07.FNT;  Hercules  Dutch  7 Punkt 

IBMHTRIO.FNT;  Hercules  Dutch  10  Punkt 

IBMHTR14.FNT;  Hercules  Dutch  14  Punkt 

IBMHTR18.FNT;  Hercules  Dutch  18  Punkt 

IBMHTR36.FNT;  Hercules  Dutch  36  Punkt 
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21  EPSM0NH6;  Epson  Matrix  Drucker  (120  x 
; Parallelschnittstelle  Nr.  1 fiir  Drucker 
EPSHSS07.FNT;  EPSON/IBM  Swiss  7 Punkt 

EPSHSSIO.FNT;  EPSON/IBM  Swiss  10  Punkt 

EPSHSS14.FNT;  EPSON/IBM  Swiss  l4  Punkt 

EPSHSS20.FNT;  EPSON/IBM  Swiss  20  Punkt 

EPSHSS28.FNT;  EPSON/IBM  Swiss  28  Punkt 

EPSHSS36.FNT;  EPSON/IBM  Swiss  36  Punkt 

EPSHTR07.FNT;  EPSON/IBM  Dutch  7 Punkt 

EPSHTRlO.FNTj  EPSON/IBM  Dutch  10  Punkt 

EPSHTR14.FNT;  EPSON/IBM  Dutch  l4  Punkt 

EPSHTR20.FNT;  EPSON/IBM  Dutch  20  Punkt 

EPSHTR28.FNT;  EPSON/IBM  Dutch  28  Punkt 

EPSHTR36.FNT;  EPSON/IBM  Dutch  36  Punkt 

31  METAFIL6;  GEM  Date! 


144  Punkte/Zoll) 

( LPTl:  ) 

(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 
(120x144  Punkte/Zoll) 


Das  GEM-System  der  o.g.  Datei  ASSIG.SYS  wird  mit  3 Ausgabegeraten  betrieben; 

1.  Die  Ausgabe  auf  den  Bildschirm  (Geratekennung  01)  erfolgt  mit  dem  Bildschirmtrei- 
ber  namens  HERMONP6.  AuBer  dem  Systemzeichensatz  (Menus,  Dialogboxen  und 
Piktogrammbeschriftungen)  stehen  2 weitere  Zeichensatze  in  je  5 Punktgrofien  zur 
Verfugung.  Es  handelt  sich  um  die  Satze  Swiss  und  Dutch  (Times  Roman)  mit  den 
Punktgrofien  7,  10,  14,  18  und  36  Punkt. 


2.  Das  zweite  Ausgabegerat  (Geratekennung  21)  ist  ein  Matrixdrucker  der  Standard- 
Epson-Serie.  Der  Treiber  heifit  EPSMONH6  und  ist  in  der  Lage,  eine  Grafikauflosung 
von  maximal  120  X 144  Punkte/Zoll  zu  erreichen.  Fiir  diesen  Treiber  stehen  die  bei- 
den  Zeichensatze  Swiss  und  Dutch  mit  den  Punktgrofien  7,  10,  14,  20  28  und  36  zur 
Verfugung. 

3.  Als  drittes  Ausgabegerat  (Geratekennung  31)  kann  der  Metadatei-Treiber  METAFIL6 
benutzt  werden.  Alle  Grafikausgaben  uber  ihn  werden  auf  eine  Datei  geschrieben,  die 
z.B.  von  GEMDRAW  oder  anderen  Grafikpaketen  wieder  eingelesen  werden  kann. 
Das  Vorhandensein  dieses  Treibers  ist  entscheidend  fiir  den  grafischen  Datenaus- 
tausch  zwischen  GEM-Programmen. 

b)  ASSIGN. SYS  auf  einem  ATARI  ST 

path  = c:\gemsys\ 

Olp  screen. sys 

IBMHSSIO.FNT 

IBMHSS14.FNT 

IBMHSS18.FNT 

IBMHSS36.FNT 

02p  screen. sys 

LOWRESIO.FNT 
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L0WRES14.FNT 

L0WRES18.FNT 

L0WRES36.FNT 

03p  screen. sys 

MEDRESIO.FNT 

MEDRES14.FNT 

MEDRES18.FNT 

MEDRES36.FNT 

04p  screen. sys 

HIRESIO.FNT 

HIRES14.FNT 

HIRES18.FNT 

HIRES36.FNT 

21  FX80.SYS 

EPSHSSIO.FNT 

EPSHSS14.FNT 

EPSHSS20.FNT 

EPSHSS28.FNT 

EPSHSS36.FNT 

31  META. SYS 


Auf  einem  ATARI  ST  gilt  fur  die  Datei  ASSIGN. SYS  im  Prinzip  das  gleiche  wie  fiir 
einen  IBM-PC.  Allerdings  gibt  es  hier  noch  einige  Besonderheiten: 

Die  erste  Zeile  der  Datei  kann  einen  Pfad,  also  Laufwerksangabe  und  Ordnerhierarchie 
beinhalten.  Er  gibt  an,  wo  sich  die  Treiber  und  Zeichensatze  befinden  sollen,  die  nachge- 
laden  werden  kdnnen. 


Wie  man  an  obigem  Beispiel  sieht,  gibt  es  vier  Ausgabegerate  fiir  den  Bildschirm,  deren 
Kennungen  von  1—4  reichen.  Es  sind  aber  keine  vier  echten  Ausgaberate  gemeint,  da 
in  alien  Fallen  der  Bildschirmtreiber  SCREEN. SYS  benutzt  wird,  der  sich  permanent 
(’p’>  im  ROM  befmdet  und  den  ATARI-Bildschirm  betreibt.  Gerat  Nummer  01,  also  der 
Bildschirm,  ist  das  Default-Ausgabegerat.  Das  GEM  dffnet  mit  dieser  Nummer  ein  physi- 
kalisches  Ausgabegerat,  bevor  der  Desktop  als  erste  Applikation  gestartet  wird.  Dies  ist 
auch  die  Nummer,  die  bei  dem  AES-Aufruf  „graf_handle“  zuruckgegeben  wird. 

Die  Nummern  2-4  beziehen  sich  auf  die  verschiedenen  Aufldsungen,  die  ein  ATARI 
ST  annehmen  kann.  Dabei  bedeuten 

02  = niedrige  Aufldsung  (low  resolution,  320x200,  16  Farben) 

03  = mittlere  Aufldsung  (medium  resolution,  640  x 200,  4 Farben) 

04  = hohe  Aufldsung  (high  resolution,  640x400,  monochrom) 

Weitere  Nummern  werden  wohl  bei  neueren  Rechnern,  wie  beim  ATARI  TT,  eine  Rolle 
spielen. 
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Wozu  werden  diese  Nummern  eigentlich  benotigt?  Im  Grunde  kame  man  mit  der  Gerate- 
kennung  01  aus.  Ladt  man  Zeichensatze  nach,  so  werden  die  entsprechenden  Zeichen- 
satze  fiir  alle  drei  Auflosungen  benutzt.  Wenn  man  sich  aber  einmal  die  mittlere  Auf- 
losung  eines  ATARI  ST  angesehen  hat,  so  stellt  man  fest,  daB  das  Verhaltnis  von  x:y 
gleich  1:2  ist,  also  y = 2x  ist.  Alle  Punkte  in  y-Richtung  sind  um  die  doppelte  Lange 
gedehnt.  Dies  sieht  man  sofort  an  den  Piktogrammen  des  Desktop,  die  in  der  Lange  ver- 
zerrt  erscheinen. 

Um  ein  Auflosungsverhaltnis  von  1:1  erreichen,  was  bei  hoher  und  niedriger  Auflbsung 
der  Fall  ist,  muBte  man  entweder  alle  Punkte  in  x-Richtung  verdoppeln  oder  alle  Punkte 
in  y-Richtung  halbieren.  Auch  Zeichensatze  sind  nur  eine  Aneinanderreihung  von  einzel- 
nen  Punkten.  Wurden  sie  fur  die  hohe  Auflbsung  entworfen,  so  erscheinen  sie  in  der  mitt- 
leren  Auflbsung  genauso  verzerrt  wie  Piktogramme.  Speziell  fiir  diese  mittlere  Auflbsung 
sollte  man  also  getrennte  Zeichensatze  entwerfen.  Um  diese  dann  auch  laden  zu  kbnnen, 
bffnet  man  eine  virtuelle  Arbeitsstation  mit  der  Nummer  03. 

Um  also  immer  in  jeder  Auflbsung  die  korrekten  Zeichensatze  parat  zu  haben,  muB  mit- 
tels  folgender  Formel  die  Geratekennung  in  Abhangigkeit  der  Auflbsung  ermittelt 
werden: 

device„id  = Getrez  ()  -I-  2; 

Als  Geratekennung  erhalt  man  2,  3 oder  4 je  nach  Auflbsung. 
c)  Treiberinformationen  ab  GEM/3 

Ab  Version  GEM/3  existiertdie  Datei  ASSIGN. SYS  nicht  mehr.  Dort  werden  die  Treiber 
der  Gerate,  die  installiert  werden  sollen,  in  den  Ordner  \GEMAPPS\GEMSYS  kopiert. 

Die  Zeichensatze  der  Ausgabegerate  werden  bei  der  Installation  in  den  Ordner 
\GEMAPPS\FONTS  kopiert. 

Wie  kann  aber  ein  Anwendungsprogramm  bestimmen,  welche  Geratetreiber  und  Zei- 
chensatze zur  verfiigung  stehen?  Dazu  wird  im  Programmer’s  Toolkit  eine  neue  VDI- 
Funktion  zur  Verfiigung  gestellt,  sie  heiBt: 

v_get_driver_info  (device_id,  info_select,  info_string) 

Beim  Aufruf  bekommt  man  zu  jeder  Geratenummer  (s.o.)  eine  Zeichenkette,  die  Infor- 
mationen  darstellt.  Diese  Informationen  werden  durch  den  Parameter  info_select  ge- 
steuert.  Er  kann  Werte  von  1 bis  5 annehmen.  Je  nach  info_select  werden  im 
info_  string  folgende  Informationen  zuruckgegeben: 

info_select  info_string 

1 Dateinamen  des  Treiber 

2 Bezeichnung  des  Gerates 

3 Zusatzinformationen,  falls  vorhanden 

4 Zeichensatzdateien  eines  Gerates 

5 Patchadresse  des  Treibers  (z.B.  Drucker-Port-Nummer) 
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Wir  schlagen  fiir  info_select  folgende  Konstanten  vor: 

# define  DRV.FNAME  1 
# define  DRV.NAMES  2 
# define  DRV_XNAMES  3 
# define  DRV.FONTS  4 
# define  DRV_PATCH  5 

Das  nachfolgende  C-Programm  listet  alle  Informationen  zu  alien  verfugbaren  Geraten 
auf; 

# include  <stdio.h> 

# include  <portab.h> 

# Include  <vdi.h> 

/*»»**»  Variablen  ***»»»»»»»»*»»)(**»»»»**»»»**»»**»»»*»»**»**»***»» / 

GLOBAL  WORD  contrl  [12]; 

GLOBAL  WORD  intin  [128]; 

GLOBAL  WORD  ptsin  [128]; 

GLOBAL  WORD  intout  [128]; 

GLOBAL  WORD  ptsout  [128]; 

/»*»***  Prototypen  / 

EXTERN  VOID  vdi  .((VOID)); 

LOCAL  VOID  v_get_driver_info  .((WORD  device.id,  WORD  info.select, 

UBYTE  »info.string)); 

/»»**»*  Funktionen  / 

LOCAL  VOID  v.get.driver.info  (device.id,  info.select,  info.string) 

WORD  device.id; 

WORD  info.select; 

UBYTE  FAR  » info.string; 

{ 

WORD  i; 

BYTE  »bptr; 

contrl  [0]  = -1; 
contrl  [1]  = 0; 
contrl  [3]  = 2; 
contrl  [5]  =4; 
contrl  [6]  =0; 

intin  [0]  = device.id; 
intin  [1]  = info.select; 
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vdi  0; 

if  (info.select  !=  DRV-PATCH) 

[ 

bptr  = (BYTE  *) intout; 

for  (i  = 0;  i < contrl  [4];  i++)  *info_string++  = »bptr++; 
*info_string  = 0; 

) /»  if  »/ 
else 

^^(WORD  *)info_string  = intout  [0]; 

] /*  v_get_driver_info  */ 

/»»*»»»»»»**»*»»**»»»»»»***»»*»»*»#»***»»**«»»**»»****»»»**»»»*»*»»/ 
GLOBAL  WORD  main  () 


UBYTE  info.string  [255]; 

WORD  device. id,  info.select,  device; 

for  (info.select  = DRV.FNAME;  info.select  <=  DRV.PATCH;  info_select++) 

[ 

printf  ("\ninfo_select:  /Sd\n",  info.select) ; 

for  (device.id  = 1;  device.id  <=  60;  device.id  +=  10) 

( 

device  = device.id; 


( 

v.get.driver.info  (device,  info.select,  info.string) ; 

if  (info.select  ==  DRV.PATCH) 

printf  ("device  id:  %2&,  info.word  = ?d\n", 
device,  *(W0RD  *)&info.string  [0]); 

else 

if  (^info.string) 

printf  ("device  id:  $2d,  info.string  = >{s\n", 
device,  info.string); 


device++; 

] while  (^info.string  &&  (device  % 10  !=  0)); 
) /*  for  */ 
j /«  for  */ 

return  (0); 

) /*  main  */ 
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Folgende  Geriite  wurden  unter  GEM/3  installiert: 


a)  eine  EGA-Karte 

b)  ein  HP-Plotter 

c)  ein  Drucker  der  Marke  EPSON  LQ 

d)  ein  Drucker  der  Marke  EPSON  FX 

e)  Treiber  fiir  Metadatei 

Dann  ist  die  Ausgabe  des  obigen  Beispielprogrammes  folgende: 


info_select:  1 
device  id:  1, 

device  id:  11, 
device  id:  21, 
device  id:  22, 
device  id:  31, 

info_select:  2 
device  id:  1, 

device  id:  11, 
device  id:  21, 
device  id:  22, 

info_select:  3 
device  id:  11, 

device  id:  21, 


info_select:  4 
device  id:  1, 

device  id:  11, 
device  id:  21, 
device  id:  22, 
device  id:  31, 

info_select:  5 
device  id:  1, 

device  id:  11, 
device  id:  12, 
device  id:  13, 
device  id:  14, 
device  id:  15, 
device  id:  16, 
device  id:  17, 
device  id:  18, 
device  id:  19, 
device  id:  21, 
device  id:  22, 


info_string  = C:\GEMAPPS\GEMSYS\SDEHF9.EGA 
info_string  = C:\GEMAPPS\GEMSYSWDHPX8.SYS 
info_string  = C:\GEMAPPS\GEMSYS\PDELQ9.ELQ 
info_string  = C:\GEMAPPS\GEMSYS\PDEHI9.EPS 
info_string  = C:\GEMAPPS\GEMSYS\MDGEM9.SYS 

info_string  = EGA  HiRes  16 
info_string  = HPGL  Plotter 
info  string  = Epson  LQ 
info_string  = IBM/Epson  Hi 

info_string  = Hewlett  Packard,  Bruning,  Calcomp 
und  andere  HP-Kompatible 
info_string  = Epson  Drucker  der  LQ  Serie 
(180x  180  Punkte/Inch) 

info_string  = C:\GEMAPPS\FONTS\*.EGA 
info„string  = C:\GEMAPPS\FONTS\*.SYS 
info_string  = C:\GEMAPPS\FONTS\*.ELQ 
info_string  = C:\GEMAPPS\FONTS\*.EPS 
info_string  = C:\GEMAPPS\FONTS\*.  SYS 

info_word  = 768 
info_word  = 3 
info_word  = 3 
info_word  = 3 
info_word  = 3 
info_word  = 3 
info  word  = 3 
info_word  = 3 
info_word  = 3 
info  word  = 3 
inf o_  word  = 1 
info_word  = 0 
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d)  Zusammenfassung 

Die  Datei  ASSIGN. SYS  wird  vom  GEM-System  benotigt,  uni  festzustellen,  welche  Aus- 
gabegerate  im  System  zur  Verfiigung  stehen  und  von  welchem  Treiber  sie  bedient  wer- 
den.  Sie  gibt  auBerdem  an,  welche  Zeichensatze  fiir  ein  Gerat  zur  Verfiigung  stehen.  Ab 
GEM/3  werden  die  Ordner  GEMSYS  und  FONTS  benutzt. 

Jedes  Gerat  wird  iiber  eine  Geratekennung  (device  handle)  angesprochen.  Offnet  man  ci- 
ne physikalische  Arbeitsstation  fur  dieses  Gerat  (v_opnwk),  so  wird  der  Geratetreiber 
geladen  und  man  kann  Ausgaben  tatigen, 

Durch  den  VDI-Befehl  vst_load_fonts  werden  automatisch  die  zusatzlichen  Zeichensat- 
ze fiir  das  angegebene  Gerat  nachgeladen,  und  man  bekommt  die  Anzahl  der  geladenen 
Zeichensatze  zuriick. 


2.3.5  Kommunikation  mil  dem  VDI 

Alle  GEM-Programme  nutzen  das  VDI,  dessen  Funktionalitat  fast  alles  bietet,  um  Grafik 
auf  ein  Ausgabegerat  zu  bringen.  Fiir  Programme,  die  in  einer  hoheren  Programmier- 
sprache  geschrieben  sind,  erfolgt  die  Nutzung  des  VDI  einfach  durch  den  Aufruf  iiber 
die  Funktionsnamen. 

Assembler-Programmierer  haben  es  da  schwerer.  Sie  miissen  verschiedene  Strukturen 
beachten,  um  die  Parameter  an  das  VDI  zu  liefern.  Obwohl  es  kaum  Sinn  macht,  VDI- 
Befehle  in  Assembler  zu  nutzen,  soli  die  Parameteriibergabe  doch  erklart  werden. 

Dies  hat  zwei  Griinde:  zum  einen  dient  es  dem  Verstandnis  des  GEM-Systems,  zum  ande- 
ren  benotigt  derjenige  diese  Information,  der  sich  naher  mit  Metadateien  beschaftigen 
mbchte. 

Das  VDI  wird  iiber  ein  einziges  Unterprogramm  aufgerufen,  dem  5 Parameter  iibergeben 
werden.  Es  handelt  sich  um  5 Felder  (arrays),  wobei  der  Grundtyp  eines  Feldes  aus  einem 
Rechnerwort,  also  16  Bit  bestehen  mu6.  Die  Felder  miissen  folgende  Namen  tragen: 

- contrl  (Funktionsangabe,  Geratekennung  usw.) 

- intin  (ganzzahlige  Eingaben) 

- ptsin  (Feld  fiir  Eingabe  von  Koordinatenpunkten) 

- intout  (ganzzahlige  Ausgaben) 

- ptsout  (Ausgaben  von  Koordinatenpunkten) 

Die  GroBen  der  Arrays  diirfen  eine  gewisse  Lange  nicht  unterschreiten.  Da  man  nie  weiB, 
ob  bei  spateren  GEM-Versionen  (X/GEM)  nicht  mehr  Feldelemente  benotigt  werden, 
werden  die  int-  und  pts-Arrays  etwas  groBziigiger  angelegt.  In  C-Schreibweise  lautet  dies: 
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GLOBAL  WORD  contrl  [12]; 

GLOBAL  WORD  Intin  [256]; 

GLOBAL  WORD  ptsin  [256]; 

GLOBAL  WORD  Intout  [256]; 

GLOBAL  WORD  ptsout  [256]; 

GLOBAL  bedeutet  in  diesem  Zusammenhang,  daB  die  Felder  beim  Linkvorgang  nach 
auBen  bin  sichtbar  sind,  WORD  bedeutet  16  Bit-Werte.  Die  Bedeutung  solcher 
Portabilitats-Makros  wird  in  Kapitel  3 geklart. 


— Der  Parameter  Block 

Er  hat  nur  Bedeutung,  wenn  man  selbst  die  Parameter  an  das  VDI  iibergeben  mochte. 
Im  Normalfall  werden  iiber  High-Level-Funktionsaufrufe  (C,  Pascal  usw.)  die  benotigten 
Parameter  aufbereitet  und  an  das  VDI  ubergeben.  Dies  besorgen  die  sogenannten  VDI- 
und  AES-Bindings  (sprich  beindings). 

Um  die  Parameter  selbst  an  das  VDI  zu  ubergeben,  muB  der  sogenannte  Parameter-Block 
erstellt  werden.  Er  hat  folgenden  einfachen  Aufbau: 


offset 

e 


4 


8 


12 


16 


Inhalte 


Adresse  d«s 
Kontrol  1-Arrasis 
Ccontrol) 


Adrasse  des 
Integer-Eingaba- 
Arrasis  Cintin) 


Adresse  des 
Koordinaten- 
Eingabe-Arrays 
CpXsin) 


Adresse  des 
Integer-Ausgabe- 
Arrays  Cintout) 


Adresse  des 
Koordinaten- 
Ausgabe-Arrays 
Cptsout) 


Par ame t er - B I oc k- F or ma t 


Abb.  2.6:  VDI  Parameter-Block 


2.3  VDI 


41 


In  C-Schreibweise  konnte  man  diesen  Block  wie  folgt  beschreiben: 


struct  vdl_parameters 

[ 

WORD  »contrl; 

WORD  *intin; 

WORD  »ptsln; 

WORD  »intout; 

WORD  *ptsout; 

]; 


struct  vdi_parameters  pblock  = 

(contrl,  intln,  ptsln,  Intout,  ptsout); 

Die  Variable  pblock  enthalt  also  die  Adressen  der  5 VDI-Parameterfelder.  Nun  muB  nur 
noch  die  Adresse  der  Variablen  pblock  sowie  eine  ID-Nummer  in  die  entsprechenden  Re- 
gister geladen  werden.  AnschlieBend  erfolgt  ein  Software-Interrupt  oder  ein  Trap-Befehl. 


a)  INTEL-Modell  (IBM  PC’s  und  Kompatible) 

Die  Adresse  des  Parameter-Blockes  muB  in  die  Register  DS:DX,  sowie  der  ID-Wert  1 139 
(Hex  $473)  in  das  Register  CX  iibertragen  werden.  AnschlieBend  muB  der  Interrupt  $EF 
ausgefiihrt  werden. 

In  8086-Assembler  konnte  dies  wie  folgt  aussehen: 


extm 

_pblock:word 

push 

ds 

mov 

dx,  sag  _pblock 

mov 

ds,  dx 

mov 

dx, offset  .pblock  ;ds:dx  zelgt  auf  den  parm  block 

mov 

cx,473h 

int 

OEFh 

pop 

ret 

ds 

b)  68000-Modell  (ATARI  ST,  TT) 

Die  Adresse  des  Parameter-Blockes  muB  in  das  Register  DLL,  sowie  der  ID-Wert  115 
(Hex  $73)  in  das  Register  DO.W  ubertragen  werden.  AnschlieBend  muB  der  Interrupt 
TRAP  #2  ausgefiihrt  werden. 
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In  68000- Assembler  konnte  dies  wie  folgt  aussehen: 

.globl  _pblock 

_vdi:  move.l  #_pblock,Dl 

move.w  #$73>D0 
trap  #2 
rts 

Fur  beide  Modelle  gilt  dann,  daii  das  VDI  angesprungen  wird  und  die  Parameter  ausge- 
wertet  werden.  Das  VDI  fiillt  die  Ausgabeparameter  intout  und  ptsout,  da  es  ja  die  Adres- 
sen  der  beiden  Felder  kennt.  Von  dort  kann  dann  die  Applikation  die  Werte  wieder  iiber- 
nehmen.  Benutzt  man  eine  hohere  Programmiersprache,  ubemehmen  die  Bindings  (VDI- 
und  AES-Libraries)  die  Ubertragung  der  Werte  aus  den  Ausgabearrays  in  die  Parameter 
der  Funktionsaufrufe. 

Da  das  Feld  „contrl“  bei  den  VDl-Aufrufen  eine  spezielle  Bedeutung  hat,  soil  der  Aufbau 
kurz  erklart  werden: 

contrl  [0]  = Opcode  (Nummer)  der  VDI-Funktion 
contrl  [1]  = Anzahl  der  x,y-Punkte  im  Feld  ptsin 
contrl  [2]  = Anzahl  der  x,y-Punkte  im  Feld  ptsout 
contrl  [3]  = L^ge  des  Feldes  intin 
contrl  [4]  = Lange  des  Feldes  intout 

contrl  [5]  = Nummer  der  Unterfunktion  fiir  GDP  oder  Escape-Funktionen 

contrl  [6]  = Geratekennung  (device  handle) 

contrl  [7..  11]  = weitere  Informationen  (Funktionsabhangig) 


2.3.6  Ein  erstes  VDI-Beispiel 

Nach  so  viel  Theorie  soil  ein  kurzes  VDI-Programm  vorgestellt  werden.  Das  Programm 
befindet  sich  auf  der  Begleitdiskette  unter  dem  Namen  „VDITEST.C“.  Es  zeichnet  ein 
rotes  Haus  aus  5 Linien  auf  den  Bildschirm.  Auf  die  Grundlinie  des  Hauses  wird  der  grii- 
ne  Text  „VDI-Test  Haus“  in  der  PunktgroBe  10  geschrieben.  An  diesem  Beispiel  sollen 
alle  VDI-typischen  Aufrufsequenzen  und  ihre  Wirkung  erlautert  werden. 

Doch  zuvor  soil  noch  kurz  auf  die  Moglichkeit  eingegangen  werden,  wie  man  das  GEM 
bzw.  VDI  auf  einem  PC  unter  MS-DOS  starten  kann. 

Um  ein  reines  VDI-Programm  unter  GEM  l.X  bzw  2.X  zu  starten,  also  ohne  Fenster 
und  Menus,  muB  „GEMVDI  /PROGRAMMNAME“  eingegeben  werden.  GDOS  und 
ASSIGN.SYS  mussen  vorhanden  sein.  Ab  GEM/3  muB  GEMVDI  -PROGRAMMNAME 
eingegeben  werden. 
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Um  normale  GEM-Programme  zu  starten,  gibt  man  „GEMVDI  FILENAME"  ein.  Der 
Desktop  wird  in  diesem  Fall  nicht  gestartet.  Wird  die  gestartete  Applikation  beendet, 
kehrt  man  zum  DOS-Prompt  zuruck. 

Um  den  GEM  Desktop  zu  starten,  muB  man  nur 

cd  \GEMSYS  bzw.  cd  \GEMAPPS\GEMSYS  bei  GEM/3 
GEMVDI 

eingeben.  Nach  der  Installierung  von  GEM  auf  einem  PC  reicht  auch  die  Eingabe  von 
GEM.  Es  handelt  sich  um  eine  Batch-Datei  (GEM. BAT),  die  vorher  noch  auf  das  Ver- 
zeichnis  (\GEMAPPS)\GEMSYS  umschaltet,  bevor  das  GEMVDI  aufgerufen  wird. 

Auf  einem  ATARI  ST  ist  es  nicht  moglich,  nur  das  VDI  zu  starten,  da  das  GEM-System 
intern  mittels  GEMVDI  gestartet  wird  und  dann  schon  der  Desktop  als  erste  Applikation 
hochkommt.  Diese  Aufruffolge  liegt  in  den  ROMs  der  ST’s  fest. 

Nun  zu  unserem  ersten  C-Beispielprogramm,  das  folgendes  tut:  Es  soil  ein  rotes  Haus 
zeichnen  und  am  unteren  Rand  des  Hauses  einen  griinen  Text  in  der  PunktgroBe  10  ausge- 
ben.  Die  Ausgabe  soli  zunachst  im  NDC-Koordinatensystem  und  dann  im  Rastersystem 
erfolgen.  AuBerdem  soil  die  Ausgabe  auf  den  Bildschirm,  den  Plotter,  den  Drucker  und 
anschlieBend  auf  eine  Datei  gelenkt  werden.  Dateien,  die  solche  Grafikbefehlsfolgen 
beinhalten,  nennt  man  auch  Metadateien.  Sie  werden  weiter  unten  erklart.  Sowohl  die 
Metadateien  als  auch  die  Bit-Image-Pixeldateien  sind  wichtigstes  Hilfsmittel,  um  grafi- 
sche  Informationen  zwischen  beliebigen  Programmen  austauschen  zu  kbnnen. 


Abb.  2.7:  Ausgabe  des  Programms  VDITEST.C  auf  den  Bildschirm 


Das  Beispiel  als  C-Programm  sieht  wie  folgt  aus: 

/*  VDI  TEST-Progranun  */ 

/*  Zelchnet  ein  Haus  und  einen  Text  */ 

/*  auf  ein  beliebiges  Ausgabeger&t  */ 
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# include  <stdio.h> 
# Include  <strlng.h> 
# include  <portab.h> 
# include  <vdi.h> 

# include  <aes.h> 


# define  SCREEN  01 
# define  PLOTTER  11 
# define  PRINTER  21 
# define  METAFILE  31 
# define  CAMERA  4l 
# define  TABLET  51 

# define  NDC  0 
# define  RC  2 


# define  VM_PAGESIZE  0 

# define  VM_C00RDS  1 

# define  SWISS  2 /»  SWISS  font  »/ 

#deflne  abs(x)  ((x)  < 0 ? -(x)  : (x))  /*  Absolut-Wert  */ 

#define  max(x,y)  (((x)  > (y))  ? (x)  : (y))  /*  Maxlmim-Funktlon  */ 

#define  rain(x,y)  (((x)  < (y))  ? (x)  : (y))  /*  Minimum  Funktlon  */ 

/iunnuHt  Varlablen  »»»» / 

GLOBAL  WORD  contrl  [12]; 

GLOBAL  WORD  intin  [128]; 

GLOBAL  WORD  ptsin  [128]; 

GLOBAL  WORD  Intout  [128]; 

GLOBAL  WORD  ptsout  [128]; 

LOCAL  WORD  work_in  [103]; 

LOCAL  WORD  work_out  [57]; 

LOCAL  WORD  vdi_handle; 

LOCAL  BOOLEAN  from_desktop; 

LOCAL  BYTE  meta_name  [80] ; 

LOCAL  WORD  mln_x,  min_y,  max_x,  max_y; 

LOCAL  WORD  screen_w,  screen_h; 

LOCAL  WORD  meta_w,  meta_h; 

/»»***»  Prototypen  *»»»****»iHHH(»*****iHHnHHt**»***»**«*)HHHt»«*»»*»** / 


EXTERN  VOID  vdl 


-((VOID)); 
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LOCAL  BOOLEAN  open_work  _((W0RD  device,  WORD  coord)); 

LOCAL  VOID  close_work  _((W0RD  device,  WORD  coord)); 

LOCAL  VOID  wait  .((VOID)); 

LOCAL  VOID  house  .((WORD  device,  WORD  coord)); 

/»»»»*»»»»#»»»*»»*»»»»»»»*»»»**»»»»*»»***»»»»»»»»»»»»**»»»»***»»»**»/ 

#if  GEMDOS  /*  Sind  ab  GEM  2.X  in  den  Bindings  »/ 

GLOBAL  VOID  vnupagesize  (vdi.handle,  pgwidth,  pgheight) 

WORD  vdi.handle,  pgwidth,  pgheight; 

[ 

contrl  [0]  = 5; 
contrl  [1]  = 0; 
contrl  [3]  = 3; 
contrl  [5]  = 99; 
contrl  [6]  = vdi.handle; 

intin  [0]  = VM.PAGESIZE; 
intin  [1]  = pgwidth; 
intin  [2]  = pgheight; 

vdi  0; 

j /*  vm.pagesize  */ 

GLOBAL  VOID  vm_coords  (vdi.handle,  llx,  lly,  urx,  ury) 

WORD  vdi.handle,  llx,  lly,  urx,  ury; 

( 

contrl  [0]  = 5; 
contrl  [1]  = 0; 
contrl  [3]  = 5; 
contrl  [5]  = 99; 
contrl  [6]  = vdi.handle; 

intin  [0]  = VM.C00RDS; 
intin  [1]  = llx; 
intin  [2]  = lly; 
intin  [3]  = urx; 
intin  [4]  = ury; 

vdi  0; 

j /*  vm.coords  */ 

#endif 
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LOCAL  BOOLEAN  open_work  (device,  coord) 

WORD  device; 

WORD  coord; 

( WORD  i; 

for  (1=0;  1 < 103;  1++)  work_ln  [1]  = 1; 

work_in  [0]  = device;  /»  device  handle  */ 

work_in  [10]  = coord;  /»  NDC/RC  Koordinaten  */ 

if  (device  !=  SCREEN)  /*  GEM/3  Erwelterungen  »/ 

( 

work_in  [11]  = 0W_N0CHANGE;  /»  Paralleler  Oder  Serleller  Port  */ 

work_in  [12]  = 0;  /*  Port  #0  */ 

) /»  if  */ 

if  (device  ==  SCREEN) 

( 

if  (fronudesktop) 

( 

appl_init  (); 

vdi_handle  = graf_handle  (&1,  &i,  &i,  &i) ; 

v_opnvwk  (work_in,  &vdi_handle,  work_out);  /*  virt.  Bffnen  */ 

graf_mouse  (M_0FF,  NULL); 


else 

( 

v_opnwk  (work_in,  &vdi_handle,  work_out);  /*  phys.  Bffnen  */ 
v_hlde_c  (vdi_handle) ; 

) /*  else  */ 


screen_w  = work_out  [0]  + 1; 
screen_h  = work.out  [1]  + 1; 

] /*  if  */ 

else  /*  nicht  Blldschlrm  */ 

v_opnwk  (work_in,  &vdi_handle,  work.out); 


if  (vdi_handle  > 0) 

( 

switch  (device) 

( 

case  SCREEN  : 
case  PLOTTER  : 
case  PRINTER  : 
case  METAFILE  : 
) /*  switch  */ 


v.clrwk  (vdi_handle) ; 
v_updwk  (vdi_handle) ; 
v_updwk  (vdl_handle) ; 
vnufilename  (vdl_handle, 


break; 

break; 

break; 

meta_name);  break; 


2.5  VDI 


47 


vst_load_fonts  (vdi_handle,  0); 

} /*  If  */ 

return  (vdi_handle  >0) 
j /»  open_work  */ 

/»»«*»»**»*»»***»»»»*#*»*)(»**»*»»»**»****»»»*»»)(**»»*»»*»»»»*»*»»)(»»/ 

LOCAL  VOID  close_work  (device,  coord) 

WORD  device; 

WORD  coord; 


WORD  llx,  lly,  urx,  ury; 

if  (device  ==  SCREEN)  wait  (); 

if  (from_desktop) 
graf_mouse  (M_0N,  NULL) ; 
else 

v_show_c  (vdi_handle,  TRUE); 


if  ( f rom_desktop  &&  device  ==  SCREEN) 

[ 

vst_unload_fonts  (vdi.handle,  0); 
v_clsvwk  (vdi_handle) ; 
appl_exit  ( ) ; 

] /*  if  */ 


else 

[ 

switch  (device) 

( 

case  SCREEN 
case  PLOTTER 
case  PRINTER 
case  METAFILE 


break; 

v_updwk  (vdi_handle) ; break; 
v_updwk  (vdi_handle) ; break; 
if  (coord  ==  NDC) 

{ 

llx  = 0; 


lly  = 0; 
urx  = meta_w; 
ury  = raeta_h; 


else  /*  RC  */ 


llx  = 0; 
lly  = meta_h; 
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urx  = meta_wj 
ury  = 0; 

] /*  else  */ 

v_meta_extents  (vdl.handle,  rain_x,  min_y, 

max_x,  max_y) ; 

/»  Letter  size  = 7,50  x 10.00  Zoll  »/ 

/*  = 19,05  X 25,40  cm  */ 

vnupageslze  (vdl_handle,  1905,  2540); 
vra_coords  (vdi_handle,  llx,  lly,  urx,  ury); 
break; 

) /*  switch  */ 

vst_unload_fonts  (vdi_handle,  0); 
v_clswk  (vdi.handle) ; 

] /»  else  */ 

] /*  close.work  */ 

/»»*»**»»»»»*»»**»»»*»*»*»*»**»**»***»»»»*»»**»»»*»»*»»»»»*»»»»»»»*»/ 
LOCAL  VOID  wait  () 

[ 

UORD  echo_xy  [2] ; 

BYTE  string  [2]; 

echo_xy  [0]  =0; 
echo_xy  [1]  =0; 

if  (froHLdesktop) 
evnt.keybd  ( ) ; 
else 

vrq_string  (vdi_handle,  1,  0,  echo_xy,  string); 

) /*  wait  */ 

/**»»**»»»»»»*»»***««»»»*)(»»*»»*»*»*»**»»»**»»******»»*»»»**»*»#»**»/ 

LOCAL  VOID  house  (device,  coord) 

WORD  device; 

WORD  coord; 


[ 

WORD  i,  pxy  [12]; 

if  (open_work  (device,  coord)) 

{ 
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if  (coord 
f 

= = 

NDC) 

pxy 

[0] 

s 

6000; 

pxy 

[1] 

= 

6000; 

pxy 

[2] 

= 

6000; 

pxy 

[3] 

= 

10000; 

pxy 

[4] 

= 

12000; 

pxy 

[5] 

= 

12000; 

pxy 

[6] 

= 

14000; 

pxy 

[7] 

= 

10000; 

pxy 

[8] 

= 

14000; 

pxy 

[9] 

= 

6000; 

pxy 

[10] 

= 

6000; 

pxy 

[11] 

= 

6000; 

if  (device  ==  METAFILE) 

( 

rain_x  = pxy  [0]; 
mln_y  = pxy  [1]; 
raax_x  = pxy  [6]; 
max_y  = pxy  [5]; 

meta_w  = 32766; 
raeta_h  = 32766; 
j /*  if  */ 

) /*  if  »/ 
else 


pxy 

[0] 

= 100; 

pxy 

[1] 

= 200; 

pxy 

[2] 

= 100; 

pxy 

[3] 

= 100; 

pxy 

[4] 

= 200; 

pxy 

[5] 

= 50; 

pxy 

[6] 

= 300; 

pxy 

[7] 

= 100; 

pxy 

[8] 

= 300; 

pxy 

[9] 

= 200; 

pxy 

[10] 

= 100; 

pxy 

[11] 

= 200; 

if  (device  ==  METAFILE) 

( 

mln_x  = pxy  [0]; 
min_y  = pxy  [5]; 
max_x  = pxy  [6]; 
max_y  = pxy  [1]; 
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meta_w  = screen. wj 
meta_h  = screen.h; 

) /*  if  V 
j /*  else  »/ 

vsl_color  (vdLhandle,  RED); 
vsl_type  (vdi.handle,  SOLID); 

v_pline  (vdLhandle,  6,  pxy);  /*  Haus  zeichnen  */ 

vswr_mode  (vdLhandle,  MD_TRANS); 
vsLcolor  (vdLhandle,  GREEN); 
vsLfont  (vdl_handle,  SWISS); 
vsLeffects  (vdLhandle,  TXLNORMAL); 

vsLalignraent  (vdLhandle,  ALI.LEFT,  ALLBOTTOM,  &i,  &i); 
vsLpoint  (vdLhandle,  10,  &!,  &!,  &1,  &i); 
vsLrotation  (vdLhandle,  0); 

v_gtext  (vdLhandle,  pxy  [0],  pxy  [1],  "VDI-Test  HAUS"); 

close.work  (device,  coord); 

) /»  if  */ 

] /*  house  */ 

GLOBAL  WORD  main  () 

( 

screen_w  = 640;  /*  default  Werte  */ 

screen_h  = 200;  /*  warden  spater  korriglert  */ 

from, desktop  = TRUE;  /*  FALSE  fiir  MSDOS,  wenn  GEMVDI  */ 

/*  direkt  gestartet  wird  */ 


house  (SCREEN,  NDC); 
house  (SCREEN,  RC); 

house  (PLOTTER,  NDC); 
house  (PLOTTER,  RC); 

house  (PRINTER,  NDC); 
house  (PRINTER,  RC); 

strcpy  (meta_name,  "HOUSENDC.GEM") ; 
house  (METAFILE,  NDC); 

strcpy  (meta_name,  "HOUSERC.GEM") ; 
house  (METAFILE,  RC) ; 
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return  (O); 

] /*  main  */ 

Zur  Schreibweise  des  Programms  soil  noch  einiges  vorweg  gesagt  werden.  In  Kapitel  3 
wind  die  Schreibweise,  die  Portabilitat  und  die  Kompatibilitat  der  Compiler  unter  sich 
genau  erlautert.  Fiir  das  Verstandnis  des  Beispiels  ist  es  aber  ausreichend,  den  nachfol- 
genden  Erlauterungen  zu  folgen. 

Damit  das  Programm  Ausgaben  tatigen  kann,  mull  es  im  groben  wie  folgt  vorgehen;  Zu- 
nachst  wird  das  Arbeitsgerat  geoffnet,  danach  konnen  Ausgaben  getatigt  werden.  Falls 
Zeichen  nicht  im  Systemzeichensatz  ausgegeben  werden  sollen,  mussen  einmalig  vor  der 
Ausgabe  Zeichensatze  geladen  werden.  Nach  der  Grafikausgabe  muB  die  Arbeitsstation 
wieder  geschlossen  werden.  Diese  Reihenfolge  ist  fiir  alle  Ausgabegerate  gleich. 

Am  Anfang  des  Programmtextes  werden  einige  Konstanten  fur  die  Ausgabegerate  defi- 
niert.  Diese  Konstanten  entsprechen  den  Geratekennungen  aus  der  Datei  ASSIGN. SYS. 
Fiir  den  Bildschirm  gibt  es  die  Kennung  1 , fiir  den  Plotter  1 1 , fiir  den  Drucker  21  und 
fiir  den  Metadatei-Treiber  die  Kennung  31. 

Die  beiden  Koordinatensysteme  NDC  und  RC  werden  beim  Offnen  der  Arbeitsstation 
verlangt.  Die  Zeichenkette  soil  im  Zeichensatz  Swiss  ausgegeben  werden,  der  unter  der 
Nummer  2 zu  erreichen  ist. 

Da  das  GEM  auf  dem  ATARI  die  beiden  Funktionen  vm_pagesize  (Metadatei- 
SeitengrdBe)  und  vm_coordinates  (Koordinatensystem  der  Metadatei)  nicht  direkt 
kennt,  werden  diese  beiden  Funktionen  spiiter  durch  direkten  Aufruf  des  VDI  nachgebil- 
det.  Sie  benutzen  die  Konstanten  VM_PAGESIZE  bzw.  VM  COORDS. 

Bei  den  Variablen  werden  zunachst  die  GEM- Arrays  contrl,  intin,  ptsin,  intout  und  ptsout 
global  erklart.  Sie  werden  bei  VDI-Befehlen  dutch  die  sogenannten  Bindings  oder  GEM- 
Libraries  gefiillt. 

Die  lokalen  Variablen  work_in  und  work_out  sowie  das  vdi_handle  werden  beim  Off- 
nen der  Arbeitsstation  sowie  fiir  VDI-Aufrufe  standig  benutzt. 

Die  Variable  from_desktop  wird  bei  einem  ATARI  ST  immer  auf  TRUE  initialisiert, 
wahrend  sie  unter  MS-DOS  mit  FALSE  vorbelegt  werden  kann,  falls  das  Beispielpro- 
gramm  direkt  iiber  das  VDI  aufgerufen  werden  soli  (GEMVDI  -VDITEST.EXE,  siehe 
2.3.5).  Wird  das  Beispiel  vom  DESKTOP  aus  gestartet,  so  ist  auch  hier  der  Wert  TRUE 
einzutragen. 

Die  Variable  meta_name  beinhaltet  den  Dateinamen  fiir  die  Ausgabe  auf  eine  Meta- 
datei, wahrend  min_x,  min_y,  max_x  und  max_y  dazu  benutzt  werden,  um  die  maxi- 
male Ausdehnung  unserer  Grafik  zu  bestimmen.  Die  Variablen  screen_w,  screen_h  so- 
wie meta  w,  meta_h  werden  dazu  benutzt,  das  Koordinatensystem  der  Metadatei  fest- 
zulegen,  wenn  es  im  Rastersystem  geoffnet  wird  (Siehe  auch  2.7.1). 
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Die  Funktion  vdi,  die  als  EXTERN  erklart  wird,  wird  nur  bei  direktem  Aufruf  des  VDl 
benotigt.  Die  Prototypen  der  vier  lokalen  Funktionen  open_work,  close_work,  wait 
und  house  sind  nur  fur  ANSI-Compiler  wie  z.B.  Turbo-C  wichtig. 

Wenn  GEMDOS  gesetzt  ist,  also  das  Beispielprogramra  auf  einem  ATARI  ST  iibersetzt 
wurde,  wird  das  GEM  noch  um  zwei  Funktionen  des  VDI  erweitert.  Diese  Funktionen 
sind  ab  GEM  2.X  unter  MS-DOS  direkt  verfugbar. 

Die  Funktion  vm_pagesize  setzt  in  den  Kopf  einer  Metadatei  die  Papierbreite  und  H6- 
he.  Der  Kopf  einer  Metadatei  enthalt  wichtige  Informationen  iiber  die  Grafikausdehnung, 
PapiergroBe  sowie  das  benutzte  Koordinatensystem.  Im  Kapitel  2.7.1  wird  der  Aufbau 
genau  beschrieben. 

Die  Funktion  vm  coords  setzt  in  den  Kopf  einer  Metadatei  Informationen  iiber  das  ver- 
wendete  Koordinatensystem.  Zusammen  mit  den  Informationen  iiber  die  PapiergroBe  laBt 
sich  spater  erst  berechnen,  wie  groB  ein  Pixel  in  einer  Metadatei  ist  (siehe  Kapitel  2.7. 1). 


Die  Funktion  open_work  benotigt  zwei  Parameter.  Zum  einen  mochte  sie  wissen,  wel- 
ches Arbeitsgerat  zu  bffnen  ist,  zum  anderen  soil  das  Arbeitsgeriit  in  einem  bestimmten 
Koordinatensystem  (NDC,  RC)  benutzt  werden. 

Zunachst  wird  das  work_in-Feld  mit  0 vorbelegt.  Das  nullte  Element  muB  mit  der  Ge- 
ratekennung  (1,  11,  21  oder  31,  siehe  ASSIGN. SYS)  vorbelegt  werden.  Das  work  in- 
Array  wurde  gleich  auf  die  Lange  von  103  Elementen  gebracht,  da  ab  GEM/3  weitere 
Angaben  gemacht  werden  konnen.  In  work_in  [10]  wird  das  gewahlte  Koordinaten- 
system eingetragen. 

Arbeitet  man  unter  GEM/3,  so  kann  noch  angegeben  werden,  ob  das  Ausgabegerat  auf 
Datei,  serielle  oder  parallele  Schnittstelle  oder  auf  die  Standardschnittstelle  ausgeben  soli. 
Die  Standardschnittstelle  wird  beim  Initialisieren  des  GEM/3  auf  dem  PC  abgefragt.  In 
work_in  [II]  geben  wir  die  Zahl  255  an  (OW_NOCHANGE  aus  VDI.H),  um  die  Stan- 
dardschnittstelle zu  wahlen. 

Ist  das  Ausgabegerat  der  Bildschirm,  so  wird  unterschieden,  ob  man  das  Programm  vom 
Desktop  aus  gestartet  hat  oder  direkt  iiber  das  VDI.  Im  ersten  Fall  wird  die  Applikation 
initialisiert  (wie  bei  jedem  GEM-AES-Programm)  und  die  physikalische  Kennung  (hand- 
le) uber  graf_handle  geholt.  Da  beim  Start  des  Desktop  das  GEM  schon  initialisiert  ist 
und  den  Bildschirm  als  physikalisches  Ausgabegerat  geoffnet  hat,  miissen  wir  den  Bild- 
schirm virtuell  bffnen  (v„opnvwk).  Jedes  Ausgabegerat  lafit  sich  namlich  nur  einmal 
physikalisch  bffnen.  AnschlieBend  wird  die  Mans  iiber  eine  AES-Funktion  versteckt. 

Im  anderen  Fall  wird  der  Bildschirm  (zum  ersten  Mai)  physikalisch  gebffnet  und  die 
Maus  iiber  die  VDTFunktion  v_hide_c  versteckt.  Die  GrbBe  des  Bildschirms  merken 
wir  uns  fiir  die  spatere  Ausgabe  auf  eine  Metadatei. 
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Wird  nicht  der  Bildschirm  als  Ausgabegerat  gewahlt,  so  konnen  wir  in  jedem  Fall  unser 
Ausgabegerat  physikalisch  offnen  (v_opnwk).  Wurde  das  Ausgabegerat  erfolgreich  ge- 
offnet  (vdi_handle  groBer  als  0),  so  werden  noch  einige  Initialisierungen  vorgenom- 
men.  Der  Bildschirmn  wird  geioscht,  Plotter  und  Drucker  werden  initial  isiert.  Schreiben 
wir  auf  eine  Metadatei,  so  wird  der  Dateiname,  der  standardmaBig  auf  GEMFILE.GEM 
eingestellt  ist,  auf  die  Variable  meta_name  gesetzt  (HOUSENDC.GEM,  HOU- 
SERC.GEM). 

Da  Text  im  proportionalen  Zeichensatz  Swiss  ausgegeben  werden  soli,  werden  die  Zei- 
chensiitze  iiber  vst_load_fonts  geladen.  Normalerweise  miifite  man  das  Funktionser- 
gebnis  iiberprufen,  das  aussagt,  wieviele  Zeichensatze  auBer  dem  Systemzeichensatz  zur 
Verfiigung  stehen.  Werden  keine  Zeichensatze  geladen,  so  erscheint  z.B.  auf  dem 
Drucker  auch  nur  das  Haus,  da  er  iiber  keinen  Systemzeichensatz  verfugt. 

Das  erfolgreiche  Offnen  der  Arbeitsstation  (vdi^handle  > 0)  wird  als  Funktionswert  zu- 
riickgegeben  und  wird  in  der  Funktion  house  weiterverwendet. 

Die  Funktion  close_work  schlieBt  das  geoffnet  Ausgabegerat  wieder.  War  es  der  Bild- 
schirm, so  wird  auf  einen  Tastendruck  gewartet.  Mit  den  entsprechenden  AES-  oder  VDI- 
Funktionen  wird  die  Maus  wieder  gezeigt.  Wurde  vom  Desktop  gestartet  und  war  das 
Ausgabegerat  der  Bildschirm,  so  werden  die  geladenen  Zeichensatze  wieder  freigegeben 
(vst_unload_fonts),  das  virtuelle  Arbeitsgerat  geschlossen  (v_clsvwk)  sowie  das  AES 
verlassen  (appLexit). 

In  alien  anderen  Fallen  werden  entsprechend  dem  Ausgabegerat  andere  AbschluBhand- 
lungen  vorgenommen.  Bei  Plotter  und  Drucker  wird  die  Grafik,  die  wir  ausgegeben  ha- 
ben  (Haus  und  Text)  und  die  zunachst  vom  VDI  gepuffert  wurde,  jetzt  aus  diesem  Puffer 
auf  das  Gerat  gebracht  (v_updwk). 

Bei  einer  Metadatei  als  Ausgabegerat  wird  entsprechend  dem  gewahlten  Koordinaten- 
system  (NDC/RC)  die  linke  untere  Ecke  (lower  left  x/y)  sowie  die  rechte  obere  Ecke  der 
maximalen  Koordinaten  innerhalb  der  Metadatei  (upper  right  x/y)  auf  folgende  GroBe  ge- 
setzt: Beim  NDC-System  auf  32766,  32766,  beim  RC-System  auf  die  aktuelle  Bild- 
schirmgroBe  (z.B.  640,  400).  Eigentlich  miifiten  die  Werte  beim  NDC-System  32767  lau- 
ten.  Leider  hat  das  GEM-Output  einen  Fehler  (bis  zur  GEM-Version  3. 1 1).  Es  berechnet 
die  Breite  und  Hohe  mit  der  iiblichen  Formel 

Breite  der  Grafik  = X2  - XI  -I-  1 = 32767  - 0 3-  1 = 32768 
Hohe  der  Grafik  = Y2  - Y1  -I-  1 = 32767  - 0 3-  1 = 32768 

Da  diese  Zahlen  aber  negativ  sind,  dreht  GEM-Output  dutch  und  zeigt  gar  nichts  mehr 
an.  Lediglich  GEMDRAW  (und  das  mitgelieferte  SHOWGEM)  kommen  mit  diesen  Wer- 
ten  zurecht.  Verringert  man  die  Ausdehnung  um  1 Pixel,  so  ergibt  sich  fiir  die  Breite 
und  Hohe  der  Wert  32767,  was  zwar  nicht  ganz  korrekt,  aber  einen  vernachlassigbaren 
Fehler  ergibt. 
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Die  drei  folgenden  Metadatei-Funktionen  bestimmen  Pixelgrdfie,  PapiergrbBe  sowie  die 
Ausdehnungen  des  Bildes  in  der  Metadatei.  Mittels  v meta  extents  gibt  man  die  grdilte 
Ausdehnung  des  Bildes  an  (min_x/y,  max_x/y).  Dieser  Wert  wird  in  der  Funktion  hou- 
se gesetzt.  Bin  Programra,  das  Metadateien  einliest,  kann  so  leicht  die  maximalen  Koordi- 
natenwerte  der  Grafik  feststellen. 

Die  Funktion  vm_pagesize  schreibt  in  die  Metadatei,  wie  grofi  die  Seite  in  1/10  mm 
war,  fiir  die  die  Grafik  erstellt  wurde.  Bine  normale  Druckerseite  im  Hochformat  z,B. 
hat  8.5  X 1 1 Zoll,  wenn  das  Bild  in  GEMDRAW  erstellt  wurde.  Da  GEMDRAW  einen 
Rand  von  0.5  Zoll  um  das  gesamte  Bild  freilaBt,  ergibt  sich  eine  GroBe  von  7.5x10  Zoll. 
Multipliziert  man  diese  Werte  mit  2.54,  so  ergibt  sich  eine  GroBe  von  19.05  x 25.4  cm 
bzw.  1905x2540  in  1/10  mm. 

Die  Funktion  vm^coords  schlieBlich  gibt  an,  wie  groB  die  Auflosung  in  x-  und  y- 
Richtung  sein  soli.  Zusammen  mit  der  SeitengroBe  (vm_pagesize)  kann  erst  errechnet 
werden,  wieviele  Punkte/cm  in  einer  Metadatei  dargestellt  wurden.  Fur  maBstabsgetreue 
Abbildungen  ist  diese  Angabe  in  einer  Metadatei  unerlaBlich.  Naheres  iiber  Metadateien 
erfahren  Sie  in  Kapitel  2.7.1.  Eine  Tabelle  aller  StandardgrdBen  und  Koordinatenwerte 
ist  dort  ebenfalls  aufgelistet.  Die  Bezeichnung  vm_pagesize  sowie  vm_coords  sind  die 
offiziellen  VDI-Namen  und  sollten  in  eigenen  Programmen  beibehalten  werden. 

Am  Ende  werden  die  geladenen  Zeichensatze  wieder  freigegeben  (vst_unload_fonts) 
und  das  Arbeitsgerat  geschlossen  (v  clswk). 

Die  Funktion  wait  wartet  auf  einen  Tastendruck,  falls  das  Programm  vom  Desktop  aus 
gestartet  wurde  (evnt_keybd).  Wird  nur  das  VDI  benutzt,  so  wird  iiber  die  Funktion 
vrq  string  auf  eine  Taste  gewartet. 


Die  Funktion  house  dffnet  das  gewahlte  Ausgabegerat  (open  work).  Im  erfolgreichen 
Falle  werden  fiir  das  NDC/RC-System  die  Koordinaten  fiir  das  Haus  in  das  Feld  pxy  ge- 
setzt. Man  beachte,  daB  im  NDC-System  der  (0,0)-Wert  in  der  linken  unteren  Ecke  liegt, 
im  RC-System  in  der  linken  oberen  Ecke.  Wurde  eine  Ausgabe  auf  eine  Metadatei  ge- 
wiinscht,  so  werden  hier  die  Variablen  min_x  usw.  bzw.  meta_w  und  meta_h  gesetzt, 
die  beim  SchlieBen  des  Gerates  benutzt  werden.  Beim  RC-System  werden  die  maximalen 
Bildschirm-Werte  auch  fiir  die  Metadatei  benutzt.  Da  das  OUTPUT  einen  Fehler  beim 
Berechnen  der  GroBe  einer  Seite  macht,  wird  die  Breite  bzw.  Hohe  im  NDC-System 
„nur“  auf  32766  gesetzt.  Dies  ist  eine  winzige  Ungenauigkeit  und  kann  vernachlassigt 
werden. 

Wurden  alle  Koordinatenwerte  gesetzt,  dann  wird  das  Haus  mittels  der  VDI-Funktion 
v_pline  ausgegeben  (Strecken-  bzw.  Polygonziige).  Vorher  wird  die  Linienfarbe  auf  rot 
(RED)  sowie  der  Linientyp  auf  durchgezogen  (SOLID)  eingestellt.  Um  den  Text  auszuge- 
ben,  mussen  verschiedene  Voreinstellungen  gemacht  werden.  Der  Schreibmodus  wird 
auf  transparent  gesetzt  (vswr_mode),  die  Textfarbe  auf  griin  (vst^color),  der  Zeichen- 
satz  auf  SWISS  (vst_font)  und  die  Text-Effekte  auf  normal  gesetzt  (vst_effects).  Die 
Textausrichtung  soli  linksbiindig  (ALI  LEFT)  sein  und  der  Text  soil  auf  der  Grundlinie 
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(ALI_BOTTOM)  des  Hauses  ausgegeben  werden.  Wir  benutzen  einen  Text  der  GroBe 
10-Punkt  (vst_point),  wobei  der  Text  um  0 Grad  rotiert,  also  von  links  nach  rechts  aus- 
gegeben werden  soil  (vst_rotation).  Schlielllich  erfolgt  die  eigentliche  Ausgabe  des 
Textes  „VDI-Test  HAUS“  im  linken  unteren  Eckpunkt  des  Hauses  (v_gtext).  Am  Ende 
wird  das  Ausgabegerat  wieder  geschlossen  (close_work). 


Das  Hauptprogramm  main  setzt  die  Bildschirmbreite  und  Hohe  auf  einen  Default- Wert. 
Er  wird  aber  korrigiert,  falls  das  Haus  auf  dem  Bildschirm  ausgegeben  werden  soil.  An- 
schlieBend  wird  die  Variable  from„desktop  vorbelegt.  Startet  man  das  Programm  vom 
Desktop  aus  (ATARI  ST  oder  IBM-PC),  so  muB  der  Wert  TRUE  sein.  Startet  man  das 
Programm  unter  MS-DOS  direkt  uber  das  VDI  (GEM VDI  / VDITEST.EXE  bei  GEM 
2.x  bzw,  GEMVDI  -VDITEST.EXE  bei  GEM/3)  so  mnB  dieser  Wert  auf  FALSE  initia- 
lisiert  werden. 

Jetzt  wird  das  Haus  auf  den  verschiedenen  Geraten  mit  den  beiden  Koordinatensystemen 
ausgegeben.  Die  Reihenfolge  ist  Bildschirm,  Plotter,  Drucker  und  Metadatei.  Soil  die 
Ausgabe  nur  auf  Bildschirm  und  Metadatei  erfolgen,  weil  kein  Plotter  oder  Drucker  ange- 
schlossen  ist,  so  kann  man  nach  Belieben  die  Funktionsaufrufe  auskommentieren. 


Zusammenfassung: 

Das  Programm  VDITEST.C  zeigt  anschaulich,  dafl  die  Grafikausgabe  auf  verschiedene 
Gerate  im  Prinzip  immer  gleich  erfolgt.  Zuerst  wird  das  entsprechende  Gerat  geoffnet, 
wobei  man  die  VDI-Kennung  (vdi_handle)  bekommt.  Mittels  Angabe  dieser  Kennung 
konnen  Grafikausgaben  getatigt  werden.  Am  Ende  wird  das  Ausgabegerat  wieder  ge- 
schlossen. 

Fiir  verschiedene  Ausgabegerate  muB  man  allerdings  einige  Sonderfalle  beriicksichtigen. 
Benutzt  man  den  Desktop  zum  Starten  von  VDI-Programmen,  so  ist  der  Bildschirm  vom 
GEM-System  schon  vorher  physikalisch  geoffnet  (v^opnwk)  worden.  In  diesem  Fall 
kann  der  Bildschirm  nur  noch  virtuell  geoffnet  werden  (v_opnvwk).  Dies  ist  fiir  den 
Programmierer  kein  Nachteil,  da  sich  nach  dem  virtuellen  Offnen  das  VDI  genauso  ver- 
halt,  als  ob  man  den  Bildschirm  physikalisch  geoffnet  hatte. 

Plotter,  Drucker,  Kameras  etc.  werden  alle  gleich  behandelt.  Eine  Ausnahme  bilden  nur 
die  Metadateien.  Hier  kann  man  nach  dem  Offnen  des  Ausgabegerates  noch  angeben,  wie 
die  Metadatei  heiBen  soil  (vm_filename).  Bei  der  Grafikausgabe  sollte  man  sich  dann 
noch  einige  Werte  merken: 

a)  die  Ausdehnung  der  Grafik 

b)  die  GroBe  der  Seite,  auf  der  Ausgaben  getatigt  wurden 

c)  die  maximalen  x-y-Werte  des  Koordinatensystems 

Vor  dem  SchlieBen  des  Ausgabegerates  Metafile  sollten  in  jedem  Falle  die  Werte  unter 
a)  — c)  eingetragen  werden.  Dafiir  existieren  die  drei  VDI-Funktionen  fiir  Metadateien 
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v_meta_extents,  vm_pagesize,  vm_coords.  Wird  dies  vergessen,  so  kann  das  Pro- 
gramm,  welches  die  produzierte  Grafik  ubernehmen  mochte,  keine  Aussagen  mehr  dar- 
iiber  machen,  wie  groB  ein  Pixel  aus  der  Metadatei  ist.  MaBstabsgetreue  Abbildungen 
sind  dann  nicht  mehr  mdglich! 


Zwei  Anmerkungen  zum  Schlufi:  Auf  dem  ATARI  ST  mu  6 bei  Verwendung  von  Turbo-C 
das  Assemblerprogramm  VDICALL.S  dazugelinkt  werden  (VDITEST.PRJ),  da  der  di- 
rekte  Aufruf  des  VDI  anders  implementiert  wurde  als  bei  alien  anderen  Compilern.  Scha- 
de  drum.  Borland  hatte  sich  erst  bei  anderen  Compilerbauern  informieren  sollen. 


Das  GDOS  auf  dem  ATARI  ST  hat  auBerdem  einen  Fehler:  Offnet  man  Metadateien  im 
NDC-Koordinatensystem,  so  werden  alle  y-Werte  von  32767  subtrahiert.  Dies  ist  ein  gro- 
ber  Fehler.  Grafikdateien  sind  dann  namlich  unbrauchbar  (das  Haus  steht  auf  dem  Kopf!). 
Es  empfiehlt  sich  also,  Metadateien  immer  im  RC-System  zu  offnen,  zumindest  so  lange, 
bis  ein  funktionierendes  GDOS  auf  dem  ST  existiert.  Das  Benutzen  des  RC-Systems  stellt 
aber  keinen  Nachteil  dar,  da  auch  hier  x-  und  y-Koordinatenwerte  bis  32767  moglich 
sind.  Lediglich  der  Ursprung  (0,0)  liegt  in  der  linken  oberen  Ecke,  was  bei  den  meisten 
bekannten  Grafikpaketen  benutzt  wird.  Die  beiden  korrekt  erzeugten  Metadateien  HOU- 
SENDC.GEM  und  HOUSERC.GEM  werden  auf  Diskette  mitgeliefert.  Sie  wurden  unter 
MS-DOS  mit  GEM/3  erstellt. 


2.3.7  Funktionen  der  VDI-Gruppen 


Die  VDI-Funktionen  wurden  schon  in  sehr  vielen  Buchern  beschrieben.  Aber  der  erkla 
rende  Text  jeder  einzelnen  Funktion  war  meist  nur  1 oder  2 Zeilen  lang.  Oft  wurde  vieles 
auch  falsch  erklart.  Es  sollen  an  dieser  Stelle  alle  Funktionen,  die  eine  ausfiihrliche  Erkla- 
rung  benotigen,  genau  besprochen  werden.  Funktionen,  die  keine  groBe  Bedeutung  ha- 
ben,  wie  z.B.  das  Zeichnen  eines  Kreises,  werden  nur  der  Vollstandigkeit  halber  aufge- 
listet. 


Zum  Nachschlagen  der  Parameter  jeder  einzelnen  Funktion  kann  ein  x-beliebiges  GEM- 
Buch  benutzt  werden.  Wir  empfehlen  das  Buch  aus  dem  gleichen  Verlag  (Softwareent- 
wicklung  auf  dem  ATARI  ST),  das  alle  GEM-Funktionen  bis  GEM  2.X  beschreibt.  Para- 
meter werden  nur  dort  erlautert,  wo  es  fiir  das  Verstandnis  wichtig  erscheint.  AuBerdem 
werden  alle  neuen  GEM/3-Funktionen  mit  Parametern  genau  erlautert,  dadiese  in  keinem 
einzigen  Buch  fiir  den  ATARI  ST  erwahnt  werden,  aber  fiir  den  einen  oder  anderen  inter- 
essant  sind,  der  Programme  fiir  ATARI  und  MS-DOS  erstellen  mochten. 


Zu  jeder  Gruppe  werden  in  einer  Tabelle  kurz  alle  Funktionen  mit  ihrem  Zweck  aufge- 
listet.  Vor  dem  C-Funktionsnamen  werden  die  Funktionsnummern  angegeben. 
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Gruppe  1:  Kontrollfunktionen 

Sie  werden  benotigt,  um  Arbeitsgerate  zu  initialisieren  und  Zeichensatze  fiir  ein  Gerat 
zu  laden. 


1 - 

v_opnwk 

Offnen  einer  Arbeitsstation 

2 - 

v_clswk 

Schliellen  einer  Arbeitsstation 

3 - 

v_clrwk 

Loschen  einer  Arbeitsstation 

4 - 

v_updwk 

gepufferte  Grafikkommandos  ausgeben 

100  - 

v_opnvwk 

virtuelle  Arbeitsstation  offnen 

101  - 

v_clsvwk 

virtuelle  Arbeitsstation  schliefien 

119  - 

vst_load_fonts 

Zeichensatze  nachladen 

119  - 

vst_ex_load_fonts 

ZeichensMze  nachladen  (GEM/3) 

120  - 

vst_unload_fonts 

Zeichensatze  freigeben 

129  - 

vs_clip 

Clipping  aus-/einschalten 

- V_OPNWK 


Dies  ist  eine der  zentralen  Funktionen.  Man ubergibt  die  Geratenummer  (siehe 2.3.4)  und 
kann  einige  Grundeinstellungen  fiir  das  Ausgabegerat  vornehmen  (Linienfarbe,  Textfar- 
be,  Linientyp  etc).  Beim  Aufrufen  der  Funktion  wird  in  der  Datei  ASSIGN. SYS  nachge- 
schaut  (bzw.  in  der  Zuweisungstabelle),  ob  ein  Treiber  fur  das  Gerat  verfugbar  ist  (z.B. 
Plotter).  Ist  er  vorhanden,  so  wird  er  geladen  und  mit  den  Einstellungen  aus  dem 
work_in-Feid  initialisiert. 


In  diesem  Falle  bekommt  man  eine  Kennung  (vdi_handle)  zuriick,  mit  der  man  alle  an- 
deren  VDI-Funktionen  aufrufen  kann.  Das  System  erkennt  anhand  dieser  Kennung  das 
angesprochene  Gerat.  Zu  jeder  Kennung  existiert  intern  ein  Satz  von  Attributen,  die  zum 
einen  durch  das  work_in-Feld,  zum  anderen  automatisch  initialisiert  wurden.  Diese  Ini- 
tialisierungen,  die  nicht  aus  dem  work_in- Array  kommen,  sind  wie  folgt  definiert: 


Textgrundlinie 

Textausrichtung 

Texteffekt 

Strichdicke 

Polyline-Enden 

Schreibmodus 

Eingabe-Modus 

Umrandung  (perimeter) 

Benutzerdefinierter  Linientyp 

Benutzerdefiniertes  Fiillmuster 

Cursor 

Clipping 


0 Grad 
links 

0 

1 

quadratisch 

ersetzen  (replace) 

request 

eingeschaltet 

durchgezogen 

DRI-/ATARI-Logo 

versteckt 

ausgeschaltet 
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Es  gibt  16  feste  Farben  in  GEM,  die  iiber  die  ersten  16  Indizes  angesprochen  werden. 
Diese  16  Farben  sollten  in  jedem  Falle  auf  jedem  Rechner  gleich  eingestellt  werden,  da 
dann  Farbgrafiken  unter  verschiedenen  Rechnern  ohne  Probleme  ausgetauscht  werden 
konnen.  Farben  ab  Index  16  aufwarts  konnen  frei  benutzt  werden.  Die  ersten  16  Farben 
werden  von  Digital  Research  wie  folgt  definiert  und  gesetzt: 


Index  Farbe 


0 

weiB  (Hintergrundfarbe) 

1 

Schwarz 

2 

rot 

3 

griin 

4 

blau 

5 

cyan  (tiirkis) 

6 

gelb 

7 

magenta  (violett) 

8 

hellgrau 

9 

dunkelgrau 

10 

dunkelrot 

11 

dunkel  griin 

12 

dunkelbiau 

13 

dunkelcyan 

14 

dunkelgelb 

15 

dunkelmagenta 

16  — n 

gerateabhangig 

Wie  diese  Einstellungen  auf  einem  ATARI  ST  in  niedriger  Auflosung  erreicht  werden, 
wird  bei  der  Funktion  Copy -Raster- Form  erlautert. 

Nach  dem  Aufruf  der  Funktion  v_opnwk  befinden  sich  im  work_out-Feld  aullerst 
wichtige  Werte.  Sie  sind  entscheidend  fiir  das  Schreiben  von  Programmen,  die  in  einer 
unabhangigen  Umgebung  (Bildschirmauflosung,  Farben  etc.)  laufen  sollen. 

Hier  gleich  ein  Hinweis  fiir  alle  ST-Programmierer;  Das  Programm  BIGSCREEN  von 
Julian  Reschke  (Mark!  & Technik)  simuliert  einen  beliebig  groBen  Bildschirm  auf  dem 
ST.  Das  Programm  lauft  auch  in  Farbe.  So  kann  man  sich  z.B.  eine  Auflosung  von 
640x400  Punkten  mit  16  Farben  herbeizaubern.  Beim  Testen  stieBen  wir  leider  nur  auf 
eine  handvoll  Programme,  die  mit  dieser  Auflosung  arbeiten  (z.B.  alle  DRI-Programme 
wie  GEMDRAW,  RCS,  ADIMENS  ST  und  WORDPLUS).  Es  gibt  etliche  Programme, 
die  nur  in  der  mittleren  Auflosung  laufen,  da  sie  meinen,  sie  hatten  dann  eine  Meniileiste 
mit  80  Zeichen.  Das  ist  aber  falsch  und  liegt  daran,  daB  diese  Programme  die  XBIOS- 
Funktion  Getrez()  benutzen,  um  die  Auflosung  festzustellen.  Wir  appellieren  daher  an 
alle  ST-Programmierer,  Getrezf)  nur  noch  dann  zu  benutzen,  wenn  das  Programm  wirk- 
lich  die  Auflosung  von  320x200  Punkten  benotigt  oder  direkt  in  das  Video-RAM  schreibt. 
Alle  anderen  Falle  konnen  mit  einer  Abfrage  der  work  out  [0]-  und  work„out  [1]- 
Werte  auskommen. 
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1st  das  Ausgabegerat  beim  Offnen  der  Arbeitsstation  eine  Metadatei,  so  wird  der  Kopf 
der  Meta-Datei  (18  VDI-Grundeinstellungen)  geschrieben.  Diese  18  Grundeinstellungen 
konnen  mit  dem  Programm  DUMPMETA.EXE  bzw.  DUMPMETA.TOS  im  Klartext 
ausgegebeti  werden.  Jeder  weitere  VDI-Befehl  mit  der  zuriickgelieferten  Kennung  wird 
dann  in  die  Meta-Datei  geschrieben. 


1st  die  Kennung  0,  so  konnte  das  Gerat  nicht  gebffnet  werden.  In  alien  anderen  Fallen 
bekommt  man  im  work_out-Feld  57  Werte  zuriick,  von  denen  einige  hier  erlautert  wer- 
den sollen; 

work  out  [0],  work_out  [1]  (s.o.:  Bemerkung  fiir  ST-Programmierer) 
work_out  [2]:  0 = Gerat  kann  prazise  skalieren 

1 = Gerat  kann  nicht  prazise  skalieren 
work_out  [3],  workout  [4]:  Pixelbreite  und  -hohe  in  1/1000  mm 


Aus  den  Werten  work_out  [2]  bis  work_out  [4]  kann  man  bestimmen,  ob  man  mafi- 
stabsgerechte  Zeichnungen  ausgeben  kann.  Fiir  einen  Drucker  z.B.  ist  der  work_out 
[2]-Wert  0.  Man  kann  also  mit  Hilfe  der  Pixelbreite-  und  -hohe  genau  sagen,  wieviele 
Pixel  man  ausgeben  mu6,  um  z.B.  eine  Linie  von  1 cm  Lange  zu  zeichnen. 


Bei  Bildschirmen  ist  der  work_out  [2]-Wert  1.  Das  bedeutet,  daft  man  nicht  genau  sa- 
gen kann,  wieviele  Pixel  man  setzen  muft,  um  eine  Linie  von  1 cm  auf  einem  Bildschirm 
zu  zeichnen.  Zwar  wird  die  Pixelbreite  und  -hohe  zuriickgegeben,  aber  es  handelt  sich 
hier  nur  um  einen  ungefahren  Wert,  da  der  Hersteller  eines  Bildschirmtreibers  ja  nicht 
wissen  kann,  welcher  Monitor  am  Rechner  angeschlossen  wird.  Die  Bildschirmdiagona- 
len  sind  ja  von  Monitor  zu  Monitor  verschieden.  Das  bedeutet,  daft  man  aus  den  Pixel- 
breiten  und  -hohen  lediglich  ablesen  kann,  ob  eine  Verzerrung  des  Bildes  stattfindet.  Ist 
die  Pixelbreite  z.B.  400/1000  mm  und  die  Pixelhohe  200/1000  mm,  so  weift  man,  daft 
die  y-Koordinaten  eines  Quadrates  immer  halb  so  groft  sein  mussen  wie  die  x- 
Koordinaten.  Man  kann  also  immerhin  das  Seitenverhaltnis  (aspect  ratio)  bestimmen. 


Wer  die  genauen  Werte  haben  mbchte,  kann  ja  seinen  Monitor  ausmessen  und  die  Breite 
sowie  Hohe  des  Monitorbildes  durch  die  Pixelanzahl  teilen.  Mit  diesen  Werten  kann  man 
maftstabsgetreu  auf  dem  Bildschirm  zeichnen. 


GEM/3  Hinweis: 

Die  Funktion  v_opnwk  wurde  geandert  (siehe  auch  VDITEST.C).  Das  work_in-Feld 
wurde  erweitert,  so  daft  zur  Laufzeit  noch  einige  Einstellungen  fiir  den  Treiber  vorge- 
nommen  werden  konnen.  Falls  jemand  fiir  den  ATARI  ST  einen  Treiber  schreiben  mbch- 
te, so  sollte  er  diese  Informationen  verwenden,  um  kompatibel  mit  zukiinftigen  GEM- 
Versionen  zu  sein. 
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work  in  [11]:  niederwertiges  Byte  = Ausgabe  auf 


0 = Datei 

1 = seriellen  Port 

2 = parallelen  Port 

3 = geratespezifisch  (direkt) 
255  = Default-Schnittstelle 


hoherwertiges  Byte  = SeitengroRe 


0 = Letter  size 
5 = Half  size 
10  = B5  size 
20  = Letter  size 
30  = A4  size 
40  = Legal  size 
50  = Double  size 
55  = Broad  sheet 
255  = Userdef 


( 8.50  X 11.00  Zoll) 

( 8.50  X 5.50  Zoll) 
(18.20  X 25.00  cm) 

( 8.50  X 11.00  Zoll) 
(21.00  X 29.70  cm) 

( 8.50  X 14.00  Zoll) 
(11.00  X 17.00  Zoll) 
(14.00  X 11.00  Zoll) 
(work_in  [101..  102]) 


Konstanten  fiir  die  obigen  Werte  befinden  sich  im  VDI.H  und  sollten  benutzt  werden. 


work_in  [12]  - work-in  [100]:  Ausgabeport  bzw.  Dateiname 

1st  work-in  [11]  = 1 oder  2,  so  muB  work  in  [12]  auf  die  Port-Nummer  gestellt  wer- 
den (LPTl  = 0,  LPT2  = 1,  COMl  = 0,  etc).  1st  work_in  [11]  = 0,  so  muB  sich  von 
work_in  [12]  an  der  Dateiname  befinden,  auf  den  geschrieben  werden  soil.  Der  Datei- 
name wird  Zeichen  fiir  Zeichen  in  die  16-Bit-Worte  work_in  [12-....]  geschrieben  und 
muB  mit  einer  0 enden. 


C-Beispiel: 

WORD  work.in  [103] J /*  Man  beachte  die  neue  Lange  */ 

BYTE  filename  [80]; 

WORD  i; 

work. in  [11]  =0; 

strcpy  (filename,  "D:\\TMP\\PRINT") ; 
for  (i  = 0;  i <=  strlen  (filename);  i-i-+) 
work.in  [i  + 12]  = filename  [i]; 

Der  Vorteil  liegt  auf  der  Hand:  Man  stelle  sich  vor,  es  gabe  ein  Accessory,  das  man 
System-Spooler  nennt.  Eine  Ausgabe  von  einem  beliebigen  Programm  konnte  statt  direkt 
auf  den  Drucker  zunachst  auf  eine  Datei  gehen.  AnschlieBend  wird  dem  Accessory  der 
Dateiname  mitgeteilt  (appl_ write).  Dieses  druckt  im  Hintergrund  Byte  fiir  Byte  die  ge- 
nannte  Datei,  da  sie  ja  schon  im  Ausgabeformat  vorliegt.  Man  konnte  dann  ohne  Proble- 
me  weiterarbeiten.  In  der  Tat  wird  dies  z.B.  in  der  GEM/3-Version  gemacht.  Dort  kann 
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man  dem  OUTPUT-Programm  sagen,  daB  es  im  Hintergrund  drucken  soil.  Es  schreibt  die 
Ausgabe  auf  eine  temporare  Datei  und  schickt  dem  Accessory  CALCLOCK.ACC  cine 
entsprechende  Meldung.  Im  AES  wird  noch  einmal  darauf  eingegangen.  Dort  wird  ge- 
zeigt,  wie  die  Meldung  fvir  den  System-Spooler  aussehen  mufi.  Falls  ein  Leser  gerne  einen 
System-Spooler  fiir  den  ATARI  ST  entwickeln  mochte,  so  sollte  er  sich  an  dicKonventio- 
nen  in  Kapitel  2.4  halten. 

work_in  [101]:  Seitenbreite  in  1/100  Zoll 
work  in  [102]:  Seitenhdhe  in  1/100  Zoll 

Ira  work_out-Feld  werden  folgende  zusatzlichen  Informationen  ausgegeben: 

work_out  [14]:  1st  11,  wenn  „Escapement  text“  verfiigbar  ist 

work_out  [24]:  Ist  11,  wenn  „ Escapement  text“  der  einzig  verfugbare  Text  auf  dem 

Ausgabegerat  ist.  Sonst  wird  10  zuriickgegeben.  Escapement  text  wird  weiter  unten 

erklart. 

work_out  [44]:  -1  bedeutet,  daB  das  Ausgabegerat  im  Querformat  ausgeben  kann,  ohne 
daB  man  selbst  die  Grafik  drehen  muB.  Das  OUTPUT-Programm  iibernimmt  beim  Quer- 
format das  Drehen  allerdings  selbst,  da  es  diese  Moglichkeit  in  alteren  GEM-Versionen 
nicht  gab. 


- V_CLSWK 

Die  angegebene  Arbeitsstation  wird  geschlossen.  Bei  Bildschirraen  wird  auf  Textdarstel- 
lung  umgeschaltet.  Plotter,  Drucker  und  Kamera  senden  ihre  gepufferten  Grafikbefehle 
auf  das  physikalische  Gerat,  bei  Metadateien  wird  ein  EOF-Zeichen  (End-Of-File)  mit 
dem  Wert  $FFFF  geschrieben  und  die  Datei  geschlossen.  Vor  Benutzen  dieses  Befehls 
miissen  alle  eventuell  virtuell  geoffneten  Arbeitsgerate  auch  wieder  virtuell  geschlossen 
werden. 


- V^CLRWK 

Die  Arbeitsstation  wird  geloscht.  Bei  Bildschirm  und  Kamera  wird  mit  der  Hintergrund- 
farbe  geloscht,  beim  Plotter  wird  der  Puffer  geloscht,  bei  einem  Drucker  wird  der  Puffer 
geloscht  und  ein  Seitenvorschub  ausgegeben.  Bei  einer  Metadatei  wird  der  Befehl  in  die 
Datei  geschrieben. 


- V_UPDWK 

Alle  gepufferten  Ausgaben  werden  jetzt  an  das  Gerat  geschickt.  Man  muB  vor  der 
Druckerausgabe  einmalig  v_updwk  aufrufen,  um  den  Drucker  zu  initialisieren. 
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- V_OPNVWK 

- V_CLSVWK 

Bildschirme  konnen  von  mehreren  Programmen  (z.B.  eine  Applikation,  mehrere  Acces- 
sories) gleichzeitig  benutzt  werden.  Der  Bildschirm  darf  allerdings  im  System  nur  einmal 
physikalisch  geoffnet  werden  (v_opnwk).  Dies  wird  beim  Initialisieren  des  GEM  getan, 
wenn  man  mit  dem  AES  bzw.  dem  Desktop  arbeitet.  Es  gibt  aber  die  Mdglichkeit,  den 
Bildschirm  dfters  zu  benutzen  als  nur  von  einer  Applikation  aus.  Dazu  kann  er  beliebig 
oft  virtuell  geoffnet  werden.  Im  Prinzip  ist  dies  die  gleiche  Funktion  wie  das  physika- 
lische  Offnen,  mit  dem  Unterschied,  daB  man  die  Kennung,  die  beim  physikalischen  Off- 
nen  zuriickgegeben  wurde,  jetzt  als  Eingabeparameter  mit  iibergibt. 

Beim  virtuellen  Offnen  des  Bildschirms  legt  der  Bildschirmtreiber  jedesmal  einen  neuen 
Satz  von  Attributen  (z.B.  Liniendicke-  und  -farbe,  Zeichensatzhdhe,  Schreibmodi  usw.) 
an.  Verschiedene  Programme  konnen  uber  die  Kennung,  die  zuriickgegeben  wird,  dann 
diese  Attribute  andern. 

Zeichnet  z.B.  ein  Programm  eine  blaue  Linie,  so  setzt  es  die  Linienfarbe  auf  Blau 
(vsLcolor)  und  tatigt  die  Ausgabe.  Ein  Accessory  kann  zwischenzeitlich  eine  rote  Linie 
zeichnen.  Es  stellt  die  Linienfarbe  also  auf  Rot.  Zeichnet  die  Applikation  nun  wieder  eine 
Linie,  so  wird  ihre  Farbe  blau  sein,  obwohl  zwischenzeitlich  auf  rot  gestellt  wurde.  Der 
Bildschirmtreiber  kann  anhand  der  Kennung  (vdi_handle)  also  feststellen,  welche  Li- 
nienfarbe zu  welcher  Applikation  gehdrt. 

Entsprechend  werden  virtuelle  Ausgabegerate  mit  v_clsvwk  wieder  geschlossen. 


- VST_LOAD_FONTS 

- VST_EX_LOAD_FONTS  (GEM/3) 

- VST_UNLOAD„FONTS 

Mit  diesen  Befehlen  ist  es  moglich,  zusatzliche  Zeichensatze  fiir  ein  Arbeitsgerat  zu 
laden.  Wie  schon  weiter  oben  erklart,  werden  die  Namen  der  Satze  aus  der  Datei 
ASSIGN. SYS  bzw.  aus  dem  \GEMAPPS\FONTS-Ordner  bei  GEM/3  geholt. 

Ein  C-Aufruf  mit 

WORD  additional; 

additional  = vst_load_fonts  (vdi_handle,  0) 

ladt  alle  Zeichensatze,  die  zusatzlich  auBer  dem  System-Zeichensatz  zur  Verfugung  ste- 
hen.  Der  Wert  additional  gibt  an,  wieviele  zusatzliche  Satze  geladen  werden  konnten. 

Ab  GEM/3  ist  es  moglich,  Zeichensatze  dynamisch  ein-  und  auszulagern  (extended  load). 
Das  GEM  iibernimmt  hier  das  Font-Swapping.  Man  iibergibt  beim  Laden  der  Satze, 
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wieviel  Speicher  man  maximal  mit  ihnen  belegen  mbchte  und  wieviel  Speicher  man  mini- 
mal frei  haben  mochte. 

Der  Aufruf  hat  dann  zwei  Parameter  mehr: 

additional  = vst_ex_load_fonts  (vdi_handle,  select,  font_max,  font_free); 

Select  muB  wie  immer  0 sein,  font_max  gibt  den  maximal  zu  reservierenden  Speicher 
an  und  font_free  den  minimalen  Speicher,  der  frei  gelassen  werden  soli. 

Default-Werte  sind: 

font_max: 

Bildschirm:  5120  ( 80  KByte) 

Drucker  : 32767  (512  KByte) 

font_free  : 

Bildschirm : 0(0  KByte) 

Drucker  ; 640  (10  KByte) 

Mit  vst_unload_fonts  werden  die  zusatzlich  geladenen  Zeichensatze  wieder  aus  dem 
Speicher  entfernt. 


- VS_CLIP 

Da  mehrere  Applikationen  den  Bildschirm  als  Ausgabegeriit  benutzen  konnen,  muB  es 
eine  Mbglichkeit  geben,  die  Grafikausgaben  so  einzuschranken,  daB  diese  nur  in  einem 
bestimmten  Bereich  des  Bildschirms  wirken.  Meist  werden  bei  GEM-Programmen  soge- 
nannte  Bildschirmfenster  benutzt.  Der  Bereich,  auf  den  man  ausgeben  mochte,  ware  dann 
das  Innere  dieses  Fensters. 

Zu  diesem  Zweck  kann  ein  sogenanntes  Clipping-Rechteck  gesetzt  werden.  Alle  Ausga- 
ben  werden  dann  nur  innerhalb  dieses  Rechteckes  ausgefiihrt.  1st  das  Rechteck  z.B. 
100x100  Pixel  groB  und  wird  eine  horizontale  Line  mit  Lange  200  Pixel  mitten  durch 
das  Rechteck  gezogen,  so  wird  die  Linie  auBen  abgeschnitten,  und  nur  der  im  Rechteck 
liegende  Teil  wird  gezeichnet.  Das  Clipping  liiBt  sich  auch  wieder  ausschalten. 


Gruppe  2:  Ausgabefunktionen 

Ausgabefunktionen  fiir  grafische  Elemente  wie  Linien,  Kreise,  Ellipsen  etc.  stehen  hier 
zur  Verfiigung.  Beim  Aufruf  der  Funktionen  werden  noch  die  zugehorigen  Attribute  be- 
nutzt. Z.B.  kann  die  Linienfarbe  auf  Rot  gestellt  werden,  wobei  dann  alle  nachfolgenden 
Zeichenfunktionen,  die  Linien  betreffen,  mit  der  Farbe  Rot  ausgegeben  werden. 
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6 — v_pline 

Linienzug 

7 — v_pmarker 

Markierungspunkt  setzen 

8 - v_gtext 

Text  ausgeben 

9 - v_fillarea 

Linienzug  mit  Flache  fullen 

10  - v_cellarray 

Raster  aus  Zellen  aufbauen 

11,1  — v_bar 

Rechteck 

11,2-  v_arc 

Kreisauschnitt 

11,3  — v_pieslice 

gefullter  Kreisauschnitt 

11,4-  v_circle 

gefullter  Kreis 

11,5  — v_ellipse 

gefiillte  Ellipse 

11,6  — v_ellarc 

elliptischer  Kreisbogen 

11,7-  v_ellpie 

gefullter  elliptischer  Kreisbogen 

11,8  — v_rbox 

Rechteck  mit  abgerundeten  Ecken 

11,9  — v_rfbox 

gefulltes  abgerundetes  Rechteck 

11,10  — v_justified 

ausgerichteter  Text 

11,11  - v_etext  (GEM/3)  erweiterte  Textausgabe 

103  — v_contourfill 

Flache  fullen 

114  - vr_recfl 

gefulltes  Rechteck  ohne  Rand 

Da  bei  den  verschiedenen  Ausgabefunktionen  Attribute  (Liniendicke,  Fiillfarbe  usw.) 
eingestellt  werden  mussen,  werden  sie  nachfolgend  tabellenartig  aufgelistet.  Somit  sieht 
man  sofort,  welche  Attribute  auf  welche  Ausgabefunktionen  wirken. 


a)  Linienattribute 

Sie  werden  bei  den  Funktionen  v_pline,  v_arc,  v_ellarc  sowie  v_rbox  benutzt. 

vsl_type  = Linientyp  (z.B.  gestrichelt) 
vsl_width  = Liniendicke 
vsl_color  = Linienfarbe 
vsl_ends  = Linienenden  (Pfeile  etc). 


b)  Attribute  fiir  Markierungspunkte  (v_pmarker) 

vsm_type  = Typ  einer  Marke  (z.B.  Kreuz) 
vsm_height  = GrdBe  einer  Marke 
vsm_color  = Farbe  einer  Marke 


c)  Attribute  fiir  flachenweises  Ausgeben 

Sie  werden  bei  den  Funktionen  v_fillarea,  v_bar,  v_pieslice,  v_circle,  v_ellipse, 
v_ellpie,  v_rfbox,  v_contourfill  und  vr_recfl  benutzt. 
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vsf_interior  = Fiillart  (z.B.  schraffiert) 
vsf_style  = Fiillstil  (z.B.  Musterart,  Schraffurart) 
vsf_color  = Fiillfarbe 

vsf_perimeter  = Umrandung  (nicht  bei  vr_recfl) 


d)  Attribute  fur  Textausgaben 


vst_height  = Schrifthohe 

vst_rotation  = Schriftrichtung  (z.B.  90  Grad) 

vst_font  = Zeichensatz 

vst_color  = Textfarbe 

vst_alignment  = Textausrichtung  (z.B.  zentriert) 

vst_effects  = Texteffekte  (z.B.  kursiv,  fett) 

vst_point  = Schrifthohe  in  Punkten  (1  Punkt  = 1/72  Zoll) 


Fur  alle  Ausgabefunktionen  ist  die  Einstellung  des  Schreibmodus  (vswr_mode)  ent- 
scheidend.  Er  bestimmt,  wie  die  Ausgabe  durchgefuhrt  wird  (transparent,  ExkJusiv-Oder 
etc.).  Die  einzelnen  Ausgabefunktionen  werden  an  dieser  Stelle  nicht  mehr  besprochen, 
da  der  Name  der  Funktion  meist  aussagt,  um  was  es  sich  handelt  (v_circle  zeichnet  na- 
turlich  einen  Kreis). 


Ein  kurzes  C-Beispiel  zeigt,  wie  die  Attributefunktionen  mit  den  Ausgabefunktionen  be- 
nutzt  werden.  Es  soli  ein  roter  Kreis  an  der  Stelle  (100,100)  mit  Radius  50  und  einem 
schraffierten  Muster  (hatch)  gezeichnet  werden,  ohne  Beriicksichtigung  des  alten  Hinter- 
grundes  (Replace-Modus).  Der  Kreis  soil  eine  Umrandung  besitzen  (perimeter). 


X = 100; 

y = 100; 
r = 50; 

vswr_mode  (vdi_handle,  MD.REPLACE) ; 
vsf_interior  (vdi_handle,  FIS.HATCH); 
vsf_style  (vdi_handle,  1); 
vsf.color  (vdi_handle,  RED); 
vsf_perimeter  (vdi_handle,  TRUE,  SOLID); 
v_oircle  (vdi_handle,  x,  y,  r) ; 


- V_ETEXT 

Die  einzige  Funktion,  die  hier  genau  erlautert  werden  soil,  ist  V_ETEXT,  da  sie  ab 
GEM/3  zur  Verfiigung  steht.  Hiermit  ist  es  moglich,  einen  Text  ab  einer  gewissen  Start- 
position  so  auszugeben,  dal)  jedes  einzelne  Zeichen  durch  seine  Distanz  (offset)  zu  dieser 
Startposition  ausgegeben  wird. 
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Der  Aufruf  lautet: 

WOF®  vdl.handle,  x,  y; 

BYTE  string  [n]; 

WORD  offsets  [n] ; 

v_etext  (vdi_handle,  x,  y,  string,  offsets); 

Die  X-  und  y-Koordinate  ist  der  Startpunkt  der  Textausgabe,  string  ist  eine  Zeichenkette, 
die  den  Text  enthalt.  In  offsets  werden  soviele  Koordinatenelemente  angegeben,  wie  sich 
Zeichen  im  string  befinden.  Der  erste  Buchstabe  benutzt  offsets  [0]  und  offsets  [1]  fiir 
die  Verschiebung  in  x-  bzw.  y-Richtung.  Der  zweite  Buchstabe  benutzt  offsets  [2]  und 
offsets  [3]  usw.  Bin  Beispiel  soil  zeigen,  wie  man  die  Proportionalschrift  wieder  entfernt. 

strcpy  (string,  "Nicht  proportional"); 
for  (1=0;  i < strlen  (string);  i++) 

{ 

offsets  [2  * i]  = 1 * 16;  /*  x-Offset  */ 
offsets  [2  * i + 1]  = 0;  /*  y-Offset  */ 

] /*  for  */ 

v_etext  (100,  100,  string,  offsets); 

Jeder  einzelne  Buchstabe  wird  ab  Koordinate  (100,100)  um  16  Pixel  weiter  nach  rechts 
ausgegeben.  Das  ’N’  erscheint  also  an  Position  (100,100),  das  ’i’  an  Position  (1 16,  100) 
usw.  Eine  Textausgabe  wie 

G 

E 

M 

ware  dann  auch  denkbar. 


- V_JUSTIFIED 

Diese  Funktion,  die  ausgerichteten  Text  auf  eine  angegebene  Lange  ausgibt,  hat  sich  ab 
GEM/3  erheblich  verandert.  Sie  wird  deshalb  ebenfalls  genauer  erlautert,  Der  Parameter 
char_width  wurde  neu  aufgenommen.  Er  gibt  die  Anzahl  der  Pixel  jedes  Buchstabens 
der  ausgegebenen  Zeichenkette  zuriick.  Diese  Ausgabeinformationen  lassen  sich  auch  ab- 
schalten.  Die  C-Syntax  lautet: 

WORD  vdi_handle; 

WORD  X,  y,  length; 

WORD  word_space,  char_space; 

BYTE  string  [n] ; 

WORD  char.wldth  [n] ; 
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v_justifled  (vdi_handle,  x,  y,  string,  length, 

word_spaee,  char_space,  char_width) ; 

Die  beiden  Parameter  word_space  und  char_space  haben  sich  wie  folgt  geandert: 

word  space; 

0x0000  = Leerzeichen  zwischen  Wortern  werden  nicht  verandert,  Ausgabeinformatio- 
nen  (char_ width)  werden  nicht  zuriickgegeben. 

0x0001  = Leerzeichen  zwischen  Wortern  werden  verandert,  Ausgabeinformationen 
(char_width)  werden  nicht  zuriickgegeben. 

0x8000  ==  Leerzeichen  zwischen  Wortern  werden  nicht  verandert,  Ausgabeinformatio- 
nen (char_width)  werden  zuriickgegeben. 

0x8001  = Leerzeichen  zwischen  Wortern  werden  verandert,  Ausgabeinformationen 
(char_ width)  werden  zuriickgegeben. 

char_space: 

0x0000  = Leerstellen  zwischen  Buchstaben  werden  nicht  verandert 
0x0001  = Leerstellen  zwischen  Buchstaben  werden  verandert 

Im  Feld  char_ width  stehen  bei  entsprechender  Angabe  von  word_space  die  Pixelbrei- 
ten  pro  Zeichen.  Das  C-Beispiel  zeigt,  wie  man  die  Informationen  bekommt. 

BYTE  *s; 

WORD  gesamt; 

s = "Test"; 
gesamt  = 0; 

v.justified  {vdi_handle,  100,  100,  s,  50, 

0x8000,  FALSE,  ehar.wldth) ; 

for  (i  = 0;  1 < strlen  (s);  i-t-i-)  gesamt  -i-=  char.width  [i]; 

Die  Variable  gesamt  enthalt  jetzt  die  Gesamtbreite  der  vier  Zeichen  der  Zeichenkette 
„TEST“. 


Gruppe  3:  Attributfunktionen 

Die  Attributfunktionen  kontrollieren  alle  Ausgabefunktionen.  Mit  ihnen  ist  es  moglich, 
Farben,  Strichdicken  und  -arten,  Fiillmuster  und  ZeichensatzgroBen  zu  verandern.  Der 
sogenannte  Schreibmodus  (writing  mode)  bestimmt,  wie  zu  setzende  Pixel  auf  schon  vor- 
handene  Pixel  gesetzt  werden. 
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12  — vst_height 

ZeichensatzgrdBe  in  Pixel 

13  — vst  rotation 

Richtung  fiir  Zeichenausgabe 

14  — vs_color 

Farbreprasentation  (Farbtabellen) 

15  - vsLtype 

Linientyp 

16  - vsl_ width 

Liniendicke 

17  - vsLcolor 

Linienfarbe 

18  - vsm_type 

Typ  der  Markierungen 

19  - vsm_height 

Hohe  von  Markierungen 

20  - vsm_color 

Farbe  von  Markierungen 

21  — vst_font 

Zeichensatz  wahlen 

22  - vsLcolor 

Farbe  von  Zeichen 

23  - vsf_interior 

Fit  Hart 

24  - vsf_style 

Fiillstil 

25  - vsf_ color 

Fullfarbe 

32  - vswr  mode 

Schreibmodus 

39  - vsLalignment 

Textaus  richtung 

104  — vsf_perimeter 

Rand  ein-/ausschalten 

106  - vst_effects 

Texteffekte  (kursiv,  fett  etc.) 

107  — vst  point 

ZeichensatzgrdBe  in  Punkt  (1/72  Zoll) 

108  - vsLends 

Typ  von  Linienenden 

112  — vsLudpat 

Benutzereigenes  Fiillmuster 

113  - vsl_udsty 

Benutzereigener  Linientyp 

Einige  wichtige  Funktionen  sollen  hier  erlautert  werden.  Alle  anderen  Funktionen  sind 
trivial  und  werden  in  anderer  Literatur  ausreichend  erklart.  An  dieser  Stelle  sei  nochmals 
vermerkt,  daB  dieses  Buch  eine  Erganzung  zu  anderen  GEM-Buchern  darstellt  und  nur 
die  Funktionen  und  GEM-Aspekte  hier  ausfiihrlich  erlautert  werden,  die  in  anderen 
Biichern  stiefmutterlich  behandelt  wurden. 


- VST_HEIGHT 


Hiermit  kann  der  aktuelle  Zeichensatz  in  der  AusgabegroBe  verstellt  werden.  Die  GroBe, 
die  man  angeben  muB,  ist  die  Anzahl  der  Pixel  von  der  Grundlinie  des  Zeichens  (base 
line)  bis  zum  oberen  Rand  (top  line).  Die  Pixelangabe  bezieht  sich  immer  auf  das  gewahl- 
te  Koordinatensystem  (NDC/RC). 


Ist  das  Ausgabegerat  der  Bildschirm,  so  versucht  das  VDI  die  gewiinschte  Zeichensatz- 
hohe  zu  wahlen.  Liegt  kein  Zeichensatz  in  der  gewunschten  GroBe  vor,  so  werden  die 
Zeichen  in  der  GroBe  uber  einen  Algorithmus  angepaBt.  Diese  Zeichen  sehen  dann  meist 
nicht  mehr  besonders  asthetisch  aus.  Das  OUTPUT-Programm  geht  diesen  Weg,  wenn 
es  Meta-Dateien  auf  dem  Bildschirm  anzeigt,  wo  die  Ausgabequalitat  auch  keine  groBe 
Rolle  spielt. 
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Auf  alien  anderen  Ausgabegeraten  (z.B.  Drucker)  werden  die  Zeichensatzgrofien  nicht 
angepaBt.  Der  Ausgabetreiber  wahlt  dann  den  nachstkieineren  Satz,  um  sicherzustellen, 
daB  die  Zeichen  eine  gewisse  Ausdehnung  nicht  iiberschreiten. 


- VST_POINT 

Diese  Funktion  ist  ahnlich  wie  vst_height.  Der  Unterschied  liegt  zum  einen  in  der  Be- 
maBung  der  GroBe  und  zum  anderen  in  der  Angabe  der  Grofle. 

Der  BemaBung  liegt  der  Begriff  „Punktgr6Be“  zugrunde.  Ein  „Punkt“  wird  als  1/72  Zoll 
(=  0.35277  mm)  interpretiert.  Sollen  Zeichen  z.B.  1/2  Zoll  groB  sein,  so  stellt  man  die 
PunktgroBe  auf  36. 

Die  Angabe  der  GroBe  bezieht  sich  hier  nicht  auf  den  Abstand  von  der  Grundlinie  zum 
oberen  Rand,  sondern  von  der  Grundlinie  einer  Textzeile  zur  Grundlinie  der  nachsten 
Textzeile.  Diese  GroBe  wird  auch  Hohe  einer  Zeichenzelle  (im  Gegensatz  zur  Hbhe  eines 
Zeichens)  genannt.  Eine  Zeichenzelle  ist  ein  Rechteck,  in  das  das  gesamte  Zeichen  ein 
schlieBlich  Ober-  und  Unterlange  hineinpaBt.  Der  Algorithmus  des  VDI  zum  Anpassen 
der  GroBe,  wie  in  vst_height  beschrieben,  wird  hier  nicht  angewendet. 


_ VS_COLOR 

Mit  Hilfe  dieser  Funktion  ist  es  mdglich,  die  allgemeine  Earbdarstellung  zu  verandern. 
Farben  unter  GEM  werden  fiber  Indizes  angesprochen  (siehe  V_OPNWK).  Index  0 ist 
die  Hintergrundfarbe  (meist  weiB),  Index  1 ist  schwarz,  Index  2 ist  rot  usw.  Es  ist  aber 
z.B.  auch  moglich,  dem  Index  2 die  Farbe  griin  zuzuordnen.  Dies  wird  intern  durch  Be- 
nutzen  von  sogenannten  Farbtabellen  (lookup  tables)  bewerkstelligt.  Sie  enthalten  zu  je- 
dem  Farbindex  eine  rechnerabhangige  Einstellung  der  drei  Werte  fur  die  Grundfarben 
Rot,  Grfin  und  Blau.  Mit  Hilfe  dieser  Farben  ist  es  moglich,  jeden  beliebigen  Farbton 
zu  mischen. 

Die  Anzahl  der  Werte  pro  Grundfarbe  bestimmt,  aus  wievielen  Farben  man  einen  Farb- 
index zusammenstellen  kann.  Bei  einem  ATARI  ST  z.B.  konnen  in  der  oiederen  Auf- 
losung  pro  Grundfarbe  8 Einstellungen  vorgenommen  werden.  Daraus  ergeben  sich  die 
Anzahl  der  Farben  zu  8x8x8  = 512  (8  verschiedene  Rot-,  Grfin-  und  Blauwerte).  Da  in 
der  niederen  Auflosung  16  Farben  gleichzeitig  darstellbar  sind,  ist  es  moglich,  jedem  die- 
ser 16  Farbindizes  einen  RGB-Wert  zuzuordnen. 

Die  Anzahl  der  Werte  pro  Grundfarbe  steigt  bei  immer  leistungsfahigerer  Hardware  an. 
So  gibt  es  heute  schon  Rechner  (z.B.  Apple  Macintosh  II)  mit  256  Stufen  pro  Grundfarbe, 
was  256x256x256  = 16777216  oder  16,7  Millionen  Farben  ergibt,  die  sich  gleichzeitig 
darstellen  lassen. 
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Eine  Grafik  mit  iiber  16  Millionen  Farben  wirkt  schon  so  realistisch,  dall  man  zum  Fer 
sehbild  keinen  Unterschied  mehr  bemerkt.  Mit  der  Funktion  vs_color  ist  es  moglich,  zu 
jedem  Farbindex  (z.B.  0-15)  die  RGB-Werte  einzustellen.  Um  auch  in  Zukunft  gewapp- 
net  zu  sein,  entschied  man  sich,  jeden  Wert  auf  ein  Promille  genau  setzen  zu  kdnnen. 
0 bedeutet  also  geringste  Farbintensitat,  1000  bedeutet  hochste  Farbintensitat.  Ein  reines 
Griin  hat  dann  die  RGB-Werte  (0, 1000,0).  Damit  kann  zu  jedem  Farbindex  aus  einer  Pa- 
lette von  1000x1000x1000  = 1 Milliarde  Farben  gewahlt  werden.  Das  durfte  auch  in  eini- 
gen  Jahren  der  dann  zur  Verftigung  stehenden  Hardware  gerecht  werden. 


- VST_FONT 


Eine  der  hervorragenden  Eigenschaften  von  GEM  ist  es,  beliebige  Zeichensatze  zu  laden 
und  auf  alien  Geraten  auszugeben.  Auch  Proportional schrift  ist  dann  moglich.  Zeichen- 
satze werden  iiber  vst_load_fonts  geladen.  Man  erhalt  die  Anzahl  der  zusatzlichen  Zei- 
chensatze, die  auf  einem  Gerat  verfugbar  sind. 


StandardmaBig  werden  zwei  Zeichensatze  mitgeliefert,  die  die  Namen  „SWISS“  und 
„DUTCH“  tragen.  Bei  einem  Bildschirm  ist  auBerdem  der  Systemzeichensatz  verfugbar 
(wird  fiir  Menus  und  Dialogboxen  benutzt).  Die  Indizes,  die  bei  vst_font  angegeben 
werden  mussen,  um  auf  einen  Zeichensatz  zu  schalten,  lauten; 


1 = Systemzeichensatz 

2 = Swiss 

3 = Swiss  Thin 

4 = Swiss  Thin  Italic 

14  = Dutch  Roman 


Um  also  auf  den  Zeichensatz  SWISS  umzuschalten,  muB 

vst_font  (vdi_handle,  2); 

aufgerufen  werden.  Die  beiden  Satze  „SWISS“  und  „DUTCH“  sind  die  einzigen  Satze, 
die  auf  alien  Ausgabegeraten  verfugbar  sind.  Z.B.  besitzt  der  Drucker  keinen  „ system 
font"  wie  der  Bildschirm.  Um  Daten  auszutauschen,  sollte  also  immer  einer  der  beiden 
Zeichensatze  gewahlt  werden,  wenn  auf  eine  Metadatei  geschrieben  wird. 


Mit  den  Funktionen  vst_Color,  vst_alignment  und  vst_effects  kdnnen  die  Textfarbe, 
die  Textausrichtung  (linksbiindig,  zentriert  etc.)  sowie  Texteffekte  (kursiv  oder  fett)  ein- 
gestellt  werden. 


2.3  VDl 


71 


- VSWR_MODE 

Bei  alien  Ausgabefunktionen  kann  global  der  sogenannte  Schreibmodus  eingestellt  wer- 
den.  Er  bestimmt,  wie  Pixel  auf  das  Ausgabegerat  gesetzt  werden  und  ob  vorhandene, 
gesetzte  Pixel  beriicksichtigt  werden.  Vier  Modi  sind  moglich: 

- replace 

- transparent 

- XOR 

- reverse  transparent 

Im  Modus  „replace“  werden  alle  Pixel  auf  dem  Ausgaberat  gesetzt,  wenn  Pixel  ausgege- 
ben  werden.  Alle  anderen  Pixel  werden  zur  Hintergrundfarbe.  Wird  z.B.  eine  gestrichelte 
Linie  ausgegeben,  so  kommt  die  Hintergrundfarbe  (meist  weiB)  an  den  Stellen  zum  Vor- 
schein,  wo  die  Linie  unterbrochen  ist.  War  der  Bildschirm  (nicht  die  Hintergrundfarbe) 
griin  und  ist  die  Strichfarbe  schwarz,  so  entsteht  eine  weiB/schwarz  gestrichelte  Linie. 

Im  Modus  „transparent“  scheint  der  Hintergrund  dort  durch,  wo  die  Linie  unterbrochen 
ist.  In  obigem  Beispiel  ist  die  Linie  griin/schwarz  gestrichelt,  da  der  Hintergund  in  den 
„L6chern“  der  Linie  durchscheint. 

Im  Modus  „XOR“  werden  einfach  alle  Pixel  invertiert.  Bei  einem  monochromen  Bild- 
schirm wird  schwarz  aus  weiB  und  umgekehrt.  Dies  wird  haufig  gebraucht,  da  die  zwei- 
malige  Anwendung  des  gleichen  Zeichenbefehls  das  Ursprungsbild  wieder  herstellt. 

Im  Modus  ..reverse  transparent"  scheint  der  Hintergrund  dort  durch,  wo  die  Linie  nicht 
unterbrochen  ist. 

- VSF_INTERIOR 

- VSF_STYLE 

Mit  diesen  beiden  Funktionen  lassen  sich  Fiilltyp  und  Fullmuster  einstellen,  die  solche 
Grafikfunktionen  wie  v_bar,  v_circle  usw.  benutzen. 

Der  Fiilltyp  (vsf_interior)  kann  5 Werte  annehmen: 

0 = Hollow  (hohl,  keine  Fullung) 

1 = Solid  (komplette  einfarbige  Fullung) 

2 = Pattern  (Fullung  mit  bestimmtem  Muster) 

3 = Hatch  (Fullung  mit  einer  Schraffur) 

4 = User  defined  (beliebiges  Fullmuster) 

Wird  der  Fiilltyp  auf  2 (Pattern)  oder  3 (Hatch)  gestellt,  so  kann  man  mit  der  Funktion 
vsf_style  zwischen  24  Mustern  bzw.  12  Schraffuren  wahlen. 
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Hohl 


Schraffur 


Muster 


2,9  2,17  3, 


3 , 10 


2,6  2,14 


2,7  2,15 


i 
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Beispiel:  Es  soil  die  Schraffur  mit  Index  2 gewahlt  werden  (siehe  auch  VDI.H); 

vsf_interior  (vdi_handle,  FIS_HATCH); 
vsf_style  (vdi_handle,  2); 


- VSF_PERIMETER 

Diese  Funktion  hat  ab  GEM/3  einen  Parameter  dazu  bekommen.  Es  handelt  sich  urn  den 
Linientyp.  So  konnen  jetzt  z.B.  gestrichelte  Umrandungen  gezogen  werden. 

Beispiel:  Setzen  des  Randes  auf  durchgezogen. 

vsf_perimeter  (vdi_handle,  TRUE,  SOLID); 


Gruppe  4:  Rasterfunktionen 

Mit  Hilfe  der  Rasterfunktionen  ist  es  moglich,  rechteckige  Blocke  von  Bits  im  Speicher 
zu  manipulieren.  Da  der  Bildschirm  ebenfalls  ein  Bitblock  ist,  konnen  die  Rasterfunktio- 
nen auch  fur  ihn  benutzt  werden. 


105 

- v_get_pixel 

Holt  ein  Pixelelement 

109 

— vro_cpyfm 

Rasteroperation,  opaque 

110 

— vr_trnfm 

Rasterblock  transformieren 

113 

- vrt_cpyfm 

Rasteroperation,  transparent 

Mit  den  Rasterfunktionen  ist  es  auch  moglich,  einen  Bildschirmbereich  in  einen  anderen 
zu  kopieren  oder  zu  verschieben.  So  wird  z.B.  das  Scrolling  in  einem  GEM-Fenster  reali- 
siert.  Man  verschiebt  eine  Zeile  Text  nach  oben,  indem  man  einen  rechteckigen  Block 
nach  oben  verschiebt  und  die  letzte,  neu  hinzugekommene  Zeile  neu  zeichnet.  Der  Vorteil 
beim  Benutzen  dieser  Funktionen  liegt  auf  der  Hand.  Sie  sind  hardwareunabhangig  und 
laufen  mit  jeder  Grafikkarte.  Grafikprozessoren  werden  dann  automatisch  unterstiitzt 
(Blitter  etc.). 

Bevor  auf  die  einzelnen  Funktionen  eingegangen  wird,  muB  der  Begriff  des  „Memory 
Form  Definition  Block  (MFDB)“  geklart  werden.  Ein  rechteckiger  Pixelblock  wird  durch 
folgende  Informationen  beschrieben: 

— Adresse  des  Bitblocks 

— Breite  und  Hohe  des  Rasters 

— Breite  des  Rasters  in  Maschinenworten  zu  16  Bits 

— Formatflag 

— Anzahl  der  Farbebenen 

— Werte  fur  zukiinftige  Erweiterungen 
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Er  wird  durch  die  C-Struktur  (VDI.H)  wie  folgt  beschrieben: 

/*  Memory  Form  Definition  Block  */ 

typedef  struct  memform 

VOID  *rap; 

WORD  fwp; 

WORD  fh; 

WORD  fww; 

WORD  ff; 

WORD  np; 

WORD  rl; 

WORD  r2; 

WORD  r3; 

] MFDB; 

Der  Wert  mp  (memory  pointer)  zeigt  auf  den  Speicherbereich  des  MFDB.  Es  kann  die 
Startadresse  eines  Puffers  sein  oder  den  Wert  0 annehmen.  1st  der  Wert  0,  so  beschreibt 
der  MFDB  keinen  Speicherbereich,  sondern  einen  Bereich  des  physikalischen  Ausgabe- 
gerates.  Offnet  man  z.B.  den  Bildschirm  als  Ausgabegerat,  so  wird  durch  die  Angabe 
von  0 im  memory  pointer  der  Bildschirm  als  Block  beschrieben.  Die  anderen  Werte  in 
der  Struktur  braucht  man  dann  nicht  mehr  anzugeben,  da  der  Ausgabetreiber  sie  ja  kennt 
(z.B.  die  Anzahl  der  Farbebenen,  Breite  und  Hohe  etc.). 

Die  Werte  fwp  (form  width  in  pixel)  und  fh  (form  height)  geben  an,  wie  groB  der  Block 
sein  soli,  den  man  beschreiben  mochte  (z.B.  100x50  Pixel).  Der  Wert  fww  (form  width 
in  words)  ist  im  Prinzip  redundante  Information  und  gibt  die  Breite  des  Blockes  in  16-Bit- 
Worten  an.  In  obigem  Beispiel  miiRte  er  den  Wert  100/16  also  6,25  haben.  In  diesem 
Falle  wird  aufgerundet  auf  7.  Auch  wenn  ein  Block  z.B.  nur  3 Bit  breit  und  20  Bits  hoch 
ist,  so  miissen  20  Worte  im  Speicher  benutzt  werden,  da  jede  neue  Pixelzeile  immer  auf 
einer  Wortgrenze  beginnt. 

Der  Wert  ff  (format  flag)  gibt  an,  ob  sich  der  Block  im  sogenannten  Standardformat  oder 
im  geratespezifischen  Format  befindet.  Das  Standardformat  ist  von  Digital  Research  fest 
vorgeschrieben  und  hat  folgenden  Aufbau: 
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Raster-Graf ik-Block 


Farb-Block  (3  Ebenen) 


Abb.  2.9:  Standard-MFDB 


Folgende  Pixelwerte  fiir  monochrome  und  farbige  MFDBs  sind  vordefiniert: 


a)  Bildschirm  mit  2 Farben  (monochrom) 

Pixelwert 

Farbindex 

Farbe 

0 

0 

well? 

1 

1 

schwarz 

b)  Bildschirm  mit  4 Farben: 

Pixelwert 

Farbindex 

Farbe 

00 

0 

weil? 

01 

2 

rot 

10 

3 

griin 

11 

1 

schwarz 
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c)  Bildschirm  mit  8 Farben: 


Pixelwert  Farbindex  Farbe 


000 

0 

weiB 

001 

2 

rot 

010 

3 

griin 

oil 

6 

gelb 

100 

4 

blau 

101 

7 

magenta 

110 

5 

cyan 

111 

1 

schwarz 

d)  Bildschirm  mit  16  Farben: 
Pixelwert  Farbindex  Farbe 

0000 

0 

weiB 

0001 

2 

rot 

0010 

3 

griin 

0011 

6 

gelb 

0100 

4 

blau 

0101 

7 

magenta 

0110 

5 

cyan 

0111 

8 

hellgrau 

1000 

9 

dunkelgrau 

1001 

10 

dunkelrot 

1010 

11 

dunkelgrun 

1011 

14 

dunkelgelb 

1100 

12 

dunkelblau 

1101 

15 

dunkelmagenta 

1110 

13 

dunkelcyan 

nil 

1 

schwarz 

Da  auf  einem  ATARI  ST  in  niedriger  Aufldsung  16  Farben  zur  Verfiigung  stehen,  sollte 
man  die  Schieberegler  im  Kontrollfeld  bzw.  im  DESKTOP. INF  wie  in  folgender  Tabelle 
einstellen.  Nur  so  kann  man  sicher  sein,  daB  eine  Grafik,  die  z.B.  von  MS-DOS  iibernom- 
men  wurde,  auch  in  den  richtigen  Farben  erscheint.  In  der  folgenden  Tabelle  wird  der 
Farbindex,  gefolgt  vom  RGB-Wert  angegeben: 


0 = 777  (weiB) 

1 = 000  (schwarz) 

2 = 700  (rot) 
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3 = 070  (grun) 

4 = 007  (blau) 

5 = 077  (cyan) 

6 = 770  (gelb) 

7 = 707  (magenta) 

8 = 666  (hellgrau) 

9 = 333  (dunkelgrau) 

10  = 500  (dunkelrot) 

11  = 050  (dunkelgrun) 

12  = 005  (dunkelblau) 

13  = 055  (dunkelcyan) 

14  = 550  (dunkelgelb) 

15  = 505  (dunkelmagenta) 

Wie  man  sieht,  gehort  zu  einem  Monochrombildschirm  eine  Farbebene,  in  dem  die  Werte 
im  Puffer  des  MFDBs  die  beiden  Farben  WeiB  und  Schwarz  beschreiben.  Jedes  Bit,  das 
im  Puffer  den  Wert  0 hat,  wird  weiB  dargestellt,  wahrend  ein  gesetztes  Bit  die  Farbe 
Schwarz  erzeugt.  Das  hdchste  Bit  des  ersten  Wortes  im  Puffer  bestimmt  also  die  Farbe 
des  Punktes  (0,0),  das  zweithdchste  Bit  die  Farbe  von  (1,0)  und  das  niederwertigste  Bit 
die  Farbe  des  Punktes  (15,0).  Um  also  den  linken  Punkt  (0,0)  auf  Schwarz  zu  setzen, 
mull  der  Puffer  folgenden  Wert  beinhalten: 

buffer  [0]  = 0x8000;  /*  = 1000000000000000  in  Blt-Schreibweise  */ 

Ahnlich  funktioniert  es  mit  einer  Farbgrafik.  Um  bei  einem  8-Farben-Schirm  den  Punkt 
(0,0)  auf  Magenta  zu  setzen,  muB  der  Pixelwert  101  in  die  einzelnen  Farbebenen  eingetra- 
gen  werden.  Bei  einer  Farbebene  der  Lange  100  Bytes  (s.  Beispiel  unten)  ware  die  Zu- 
weisung: 

buffer  [0]  = 0x8000;  /*  = 1000000000000000  */  . . 

buffer  [100]  =0;  /*  = 0000000000000000  «/ 

buffer  [200]  = 0x8000;  /*  = 1000000000000000  */ 

Die  Anzahl  der  Farbebenen  kann  man  dutch  den  VDI-Aufruf  vq_extnd  bestimmen 
(work_out  [4]). 

Da  es  sehr  viele  Rechner  und  Grafikkarten  auf  dem  Markt  gibt,  weiB  ein  GEM- 
Programmierer  nie,  wie  der  Bildschirmspeicher  des  gerade  angeschlossenen  Ausgabe- 
gerates  intern  aufgebaut  ist.  Wiirde  er  direkt  ins  Video-Ram  schreiben,  so  wiirde  sein 
Programm  auf  anderen  Rechnern  oder  Grafikkarten  abstiirzen  oder  andere  unerwartete 
Effekte  zeigen. 

Zu  diesem  Zweck  wurde  ein  Standardformat  vorgeschlagen.  Das  VDI  stellt  eine  Funktion 
(vr_trnfm)  zur  Verfiigung,  mit  der  man  eine  Umwandlung  vom  Standardformat  in  das 
Gerateformat  vornehmen  kann. 

Mdchte  man  z.B.  eine  Farbgrafik  mit  80x20  Pixel  und  8 Farben  erzeugen  und  weiB  nicht, 
wie  der  Bildschirm  intern  aufgebaut  ist,  so  legt  man  sich  im  Speicher  einen  Bereich  an, 
in  dem  das  Bild  aufgebaut  wird.  Dieser  Speicherbereich  miiBte  100  = 80/16x20  Bytes 
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pro  Farbebene  groB  sein.  Da  man  8 = Farben  haben  mochte,  braucht  man  3 Ebenen 
(planes),  also  300  Bytes.  Die  Belegung  des  MFDB  sahe  dann  wie  folgt  aus: 

MFDB  mfdb; 

BYTE  buffer  [300] j 

mfdb.mp  = (VOID  *)buffer; 

mfdb.fwp  = 80; 

mfdb.fh  = 20; 

mfdb.fww  =5; 

mfdb.ff  =1; 

mfdb.np  = 3; 

Der  Puffer  enthiilt  die  Informationen,  wie  in  Abb.  2.9  beschrieben.  Die  Farbgrafik  kann 
auf  den  Bildschirm  gebracht  werden,  indem  man  zuerst  die  VDl-Transformationsfunktion 
aufruft.  Dadurch  wird  die  komplette  Grafik  an  die  Grafikkarte  angepaBt.  AnschlieBend 
kann  dann  mit  der  Funktion  vro_cpyfm  der  gesamte  Block  auf  den  Bildschirm  geschrie- 
ben  werden. 

Noch  ein  Beispiel:  Piktogramme  in  Resource- Dateien  befinden  sich  immer  im  Standard- 
format.  Wird  eine  Dialogbox,  die  Piktogramme  enthalt,  mit  der  AES-Funktion 
objc_draw  auf  den  Bildschirm  gezeichnet,  so  werden  die  Piktogramme  (kleine  MFDBs) 
vorher  nicht  automatisch  transformiert,  sondern  direkt  in  den  Bildschirm  kopiert.  Bei  ei- 
nem  ATARI  ST  ist  dies  nicht  weiter  tragisch,  da  das  Standardformat  genau  dem  gerate- 
spezifischen  Format  entspricht. 

Wer  aber  GEM-Software  auf  MS-DOS  portiert,  erlebt  sein  „erstes“  Wunder,  wenn  Pik- 
togramme z.B.  auf  einer  EGA-Karte  gezeichnet  werden.  Sie  werden  invers  und  verdreht 
dargestellt,  da  die  EGA-Karte  nicht  dem  Standardformat  entspricht.  Wandelt  man  die 
Piktogramme  einer  RSC-Datei  aber  mittels  vr  trnfm  um,  so  erscheinen  die  Piktogram- 
me wieder  richtig.  Auf  einem  ATARI  ST  kann  diese  Funktion  ruhig  aufgerufen  werden, 
da  sie  keine  Anderungen  der  Piktogramme  vornimmt.  Wie  dies  genau  gemacht  wird,  er- 
kennt  man  sofort  an  dem  Modul  RESOURCE,  das  auf  der  Begleitdiskette  enthalten  ist. 

Wenn  man  Rasteroperationen  vornimmt,  so  kann  man  auch  noch  angeben,  wie  zu  setzen- 
de  Pixel  mit  den  schon  vorhandenen  Pixeln  logisch  verkniipft  werden  sollen.  Die  Kon- 
stanten  befinden  sich  in  der  Datei  VDI.H  (bit  bit  rules)  und  sollten  benutzt  werden.  Sie 
beginnen  mit  ALL_WHITE  (0)  und  enden  mit  ALL_BLACK  (15).  Dabei  bedeutet  S 
die  Quelle  (source)  und  D das  Ziel  (destination). 


- VRO_CPYFM 

Dies  ist  die  wichtigste  Funktion  aus  der  Raster-Gruppe.  Mit  ihr  konnen  rechteckige  Bild- 
ausschnitte  kopiert  (verschoben)  werden,  wobei  eine  logische  Operation  angegeben  wird. 
Auch  Bildschirmbereiche  konnen  in  einen  Speicherbereich  und  umgekehrt  verschoben 
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werden  (z.B.  fur  das  Retten  des  Hintergrundes).  Das  hardwareunabhangige  Scrollen  in 
Fenstern  wird  mit  Hilfe  dieser  Funktion  erst  moglich.  AuBerdem  iibergibt  man  der  Funk- 
tion  zwei  Rechtecke,  die  die  Quelle  und  das  Ziel  auf  dem  Ausgabegerat  bestimmen.  Wenn 
die  beiden  angegebenen  MFDBs  gleich  sind  (z.B.  Kopieren  von  Bildschirm  nach  Bild- 
schirm),  so  spielt  die  Angabe  der  Rechtecke  keine  Rolle.  D.h.  auch  iiberlappende  Recht- 
ecke von  Quelle  und  Ziel  werden  korrekt  kopiert.  Die  beiden  angegebenen  MFDBs  miis- 
sen  sich  beide  im  geratespezifischen  Format  befinden. 

Sind  Quellen-  und  Zielrechteck  nicht  gleich  groB,  so  wird  in  die  Adresse  des  Zieles  ko- 
piert und  das  Quellraster  entsprechend  verkleinert  Oder  vergroBert.  RastervergroBerun- 
gen  bzw.  verkleinerungen  sind  also  mit  einem  Aufruf  zu  machen.  Allerdings  muB  der 
Treiber  des  Ausgabegerates  dies  unterstiitzen.  Zur  Abfrage  kann  die  VDI-Funktion 
vq  extnd  (work  out  [3])  benutzt  werden. 


- VR_TRNFM 

Wie  weiter  oben  erwahnt  wurde,  gibt  es  zwei  Formate:  Das  Standardformat  und  das  gera- 
tespezifische  Format.  Standardformate  werden  u.a.  in  Resource-Dateien  fiir  Icons  und 
Bit-Images  benutzt. 

Bevor  diese  auf  den  Bildschirm  ausgegeben  werden  konnen,  miissen  sie  in  das  Format 
des  Ausgabegerates  iiberfiihrt  werden. 

Das  VDI  gibt  beim  Zeichnen  von  Icons  und  Bit-Images  in  Dialogboxen  nur  noch  die  rei- 
nen  Pixeldaten  auf  den  Bildschirm  aus.  Dadurch  spart  es  sich  viel  Zeit,  da  Piktogramme 
meist  dfters  gezeichnet  werden  sollen.  Das  bedeutet,  daB  sich  der  Programmierer  darum 
kiimmern  muB,  die  Daten  aus  den  Piktogrammen  und  Zeichnungen  vom  Standardformat 
in  das  Gerateformat  zu  transformieren.  Dies  ubernimmt  aber  gliicklicherweise  die  Funk- 
tion vr_trnfm,  die  lediglich  pro  Piktogramm  oder  Zeichnung  einmal  aufgerufen  werden 
muB.  Sie  invertiert  Bits  und  vertauscht  die  Bit-Reihenfolge  eines  Blocks,  falls  das  Ausga- 
begerat dies  benotigt.  Man  iibergibt  ein  Flag,  in  welchem  Format  sich  der  Quell-Bit- 
Block  befindet,  und  die  Funktion  wandelt  den  kompletten  Block  in  den  Ziel-Block  urn, 
wobei  sie  das  Flag  invertiert. 

Die  beiden  Blocke  miissen  entweder  exakt  identisch  sein  oder  komplett  verschieden. 
Uberlappungen  sind  nicht  erlaubt.  So  ist  es  moglich,  einen  Standardformat  Block  und  ei- 
nen  geratespezifischen  Block  gleichzeitig  zu  handhaben  oder  den  Block  in  sich  selbst  um- 
zuwandeln.  Das  Umwandeln  in  sich  selbst  wird  im  Modul  RESOURCE  auf  der  beiliegen- 
den  Diskette  behandelt.  Alle  Piktogramme  und  Bitblocke  werden  vom  Standardformat  ins 
geratespezifische  Format  umgewandelt. 


-VRT_CPYFM 

liber  diese  Funktion  wurde  in  keinem  Buch  ausfuhrlicher  gesprochen.  Der  Grund  liegt 
wahrscheinlich  daran,  dafl  sie  nie  richtig  verstanden  wurde.  Man  stelle  sich  vor, 
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man  erzeuge  Piktogramme  im  Resource-Construction-Set.  Diese  Piktogramme  sind  mo- 
nochrome Grafikblocke,  also  mit  nur  1 Farbebene.  Die  Tatsache,  daJi  man  Piktogrammen 
eine  Farbe  geben  kann,  spielt  keine  Rolle,  da  sie  ja  nicht  mehrfarbig  sein  konnen.  Nun 
mochte  man  diese  Piktogramme  nicht  uber  eine  Dialogbox  vom  AES  gezeichnet  haben, 
sondern  mochte  sie  selbst  benutzen. 

Wenn  ein  Farbbildschirm  angeschlossen  ist,  so  wird  der  Befehl  vro_cpyfm  keine  Hilfe 
sein,  da  das  Quellraster  1 Farbebene,  das  Zielraster  aber  4 Farbebenen  (bei  16  Farben) 
besitzt.  Hier  greift  nun  die  Funktion  vrt_cpyfm  ein,  Mit  ihr  ist  es  moglich,  ein  einfarbi- 
ges  Quellraster  in  ein  mehrfarbiges  Zielraster  zu  kopieren.  Man  gibt  die  beiden  Farben 
an,  die  fiir  gesetzte  und  nicht  gesetzte  Pixel  aus  dem  Quellraster  benutzt  werden  sollen. 

Ohne  diese  Funktion  ware  es  nicht  moglich,  Piktogramme  bzw.  Bitblocke  fur  benutzer- 
definierte  Objekte  zu  gebrauchen.  Solche  Objekte  konnen  nur  mit  Hilfe  des  VDI  gezeich- 
net werden.  Ein  Beispiel  befindet  sich  im  Modul  RESOURCE  oder  im  Programm 
SHOWGEM,  in  dem  sogenannte  (Macintosh  )Radio-Buttons  (rund  mit  schwarzem  Kern) 
in  Dialogboxen  gezeichnet  werden. 


- Gruppe  5:  Eingabefunktionen 

Diese  Funktionen  werden  vom  AES  benutzt,  um  die  Maus  zu  steuern  und  urn  Tastaturein- 
gaben  vornehmen  zu  konnen.  Da  sie  aber  von  einem  GEM-Anwendungsprogramm  nicht 
benutzt  werden  diirfen,  werden  sie  nur  der  Vollstandigkeit  halber  aufgefiihrt.  Lediglich 
Programme,  die  nur  auf  dem  VDI  aufsetzen,  konnen  Nutzen  aus  ihnen  ziehen. 


28 

vrq_locator 

Input  locator,  Anfragemodus 

28 

— vsm_locator 

Input  locator,  Testmodus 

29 

— vrq_valuator 

Input  valuator,  Anfragemodus 

29 

— vsm_valuator 

Input  valuator,  Testmodus 

30 

— vrq  choice 

Input  choice,  Anfragemodus 

30 

— vsm_choice 

Input  choice,  Testmodus 

31 

— vrq_string 

Input  string,  Anfragemodus 

31 

— vsm_string 

Input  string,  Testmodus 

33 

— vsin  mode 

Eingabemodus  wahlen 

111 

- vsc_form 

Mausform  setzen 

118 

- vex_timv 

Timer  Interrupt  verandern 

122 

— v_show_c 

Cursor  zeigen 

123 

— v_hide_c 

Cursor  verstecken 

124 

— v_qmouse 

Maustasten  abfragen 

125 

— vex_butv 

Mausknopfvektor  verandern 

126 

— vex_motv 

Mausbewegungsvektor  verandern 

127 

— vex_curv 

Cursorzeichenvektor  verandern 

128 

- vq_key_s 

Tastaturstatus  holen 
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- VSIN_MODE 

Mit  Hilfe  dieser  Funktion  kann  das  Eingabegerat  und  dessen  Funktionsweise  eingestellt 
werden.  Eingabegeriite  konnen  sein: 

a)  locator  (Maus,  Trackball,  Joystick) 

b)  valuator  (Potentiometer) 

c)  choice  (Funktionstasten) 

d)  string  (Tastatur) 

Die  Funktionsweise  kann  auf  Request  oder  Sample  geschaltet  werden.  Im  Request  Modus 
wartet  der  Eingabetreiber,  bis  ein  Eingabeereignis  vorliegt  und  kehrt  dann  erst  zuruck. 
Im  Sample-Modus  wird  der  Status  ohne  zu  warten  zuriickgegeben. 


- VEX  TIMV 

- VEX_BUTV 

- VEX_MOTV 

- VEX_CURV 

Zu  diesen  Funktionen  soil  gesagt  werden,  daC  sie  nur  von  den  Applikationen  verwendet 
werden  konnen,  die  die  physikalische  Arbeitsstation  geoffnet  haben.  Sie  sind  also  fiir 
GEM-Applikationen  unbrauchbar. 


- Gruppe  6:  Nachfragefunktionen 

Um  GEM-Programme  moglichst  unabhangig  von  der  zugrundeliegenden  Hardware  zu 
schreiben,  mu6  es  Funktionen  geben,  mit  denen  man  alle  Informationen  iiber  die  ange- 
schlossenen  Gerate  erfragen  kann.  Sowohl  die  Nachfrage  als  auch  die  Escape-Funktionen 
erfiillen  diesen  Zweck. 


26  - 

vq_color 

Farbeinstell  ungen  erfragen 

27  - 

vq_cellarray 

Zellenraster  erfragen 

35  - 

vql_attributes 

Linienattribute  erfragen 

36  - 

vqm_attributes 

Polymarkerattribute  erfragen 

37  - 

vqf_  attributes 

Fiillflachenattribute  erfragen 

38  - 

vqt_attributes 

Textattribute  erfragen 

102  - 

vq_extnd 

Weitere  Gerateinformationen  holen 

115  - 

vq_inmode 

Eingabemodus  erfragen 

116  - 

vqt_extent 

Textrahmen  erfragen 

117  - 

vqt_width 

ZeichengroBe  erfragen 

130  - 

vqt_name 

Zeichensatzname  und  Index  erfragen 

131  - 

vqt_font_info 

Zeichensatzinformationen  erfragen 

132  - 

vqt_justified 

Informationen  iiber  ausgerichteten  Text  erfragen 
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Die  meisten  der  o.g.  Funktionen  erklaren  sich  von  selbst  und  sind  in  anderen  Biichern 
ausreichend  beschrieben.  Wir  werden  daher  nur  noch  auf  die  Funktionen  eingehen,  bei 
denen  die  meisten  Schwierigkeiten  bestehen  bzw.  die  zum  Verstandnis  notwendig  sind. 


- VQ_EXTND 

Hiermit  kdnnen  weitere  Gerateinformationen  geholt  werden.  Interessant  sind  bier  folgen- 
de  Werte: 


work_out  [3]:  Skalierung  von  Rasterblocken 
work„out  [4]:  Anzahl  der  Farbebenen 


Fine  1 sagt  aus,  da6  man  bei  der  Funktion  vro_cpfm  von  einem  Rechteck  aus  in  ein 
kleineres  oder  groBeres  Rechteck  kopieren  kann  und  daB  das  VDI  die  Verkleinerung/Ver- 
groBerung  selbst  vornimmt.  Bei  pixelorientierten  Zeichenprogrammen  kann  dies  eine 
sehr  groBe  Hilfe  darstellen.  Im  tibrigen  werden  Zeichensatze  auf  Bildschirmen  mit  der 
Funktion  vst_height  ebenfalls  beliebig  skaliert. 

Ab  GEM/3  werden  die  Felder  work_out  [20]  bis  work_out  [27]  wie  folgt  benutzt: 


work_out 


work_out 

work_out 

work„out 

work_out 

work_out 


[20] :  Erweiterte  Informationen  zur  PixelgroBe  in  Micrometer, 

diese  werden  dann  in  work_out  [21]  und  work_out  [22] 
zuruckgegeben 

0 = keine  weiteren  Informationen  vorhanden 

1 = PixelgroBe  in  1/10000  mm 

2 = PixelgroBe  in  1/100000  mm 

3 = PixelgroBe  in  1/1000000  mm 

[21] :  Punktbreite  in  Einheiten  aus  work_out  [20] 

[22] :  Punkthdhe  in  Einheiten  aus  work_out  [20] 

[23] :  Punkte/Zoll  in  x-Richtung 

[24] :  Punkte/Zoll  in  y-Richtung 

[25] :  Flag,  urn  anzuzeigen,  ob  Bit-Image  Dateien  auf  Druckern 

vom  Treiber  gedreht  werden  kdnnen. 

0 = Nein 


1 = Drehungen  um  0,  90,  180  und  270  Grad  erlaubt 
work_out  [26]  — work  out  [27]:  Adresse  des  Bildschirmpuffers,  der  bei 
AES-Funktionen  benutzt  wird  (1/4  des  Gesamtschirms). 


- VQT  EXTENT 

Hiermit  kann  zu  einer  gegebenen  Zeichenkette  ein  Rahmen  erfragt  werden,  der  genau 
um  die  Zeichenkette  paBt.  Alle  Zeichenattribute  werden  beriicksichtigt.  Man  erspart  sich 
damit  das  Ausrechnen,  ob  eine  Zeichenkette  noch  in  einen  bestimmten  Bereich  einer  Gra- 
fik  hineinpaBt.  Zuruckgegeben  werden  4 Punkte  (relativ,  keine  Bildschirmkoordinaten), 
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die  Eckpunkte  der  Zeichenkette,  beginnend  links  unten.  Leider  funktioniert  dies  auf  ei- 
nem  ATARI  ST  nicht,  wenn  die  Zeichenkette  Umlaute  enth^t,  da  die  alte  GEM-Version 
mit  Umlauten  noch  nicht  umgehen  konnte. 


- VQT_NAME 


Mit  der  Funktion  vst_load_fonts  (s.o.)  konnten  externe  Zeichensatze  nachgeladen  wer- 
den.  Dabei  war  der  Funktionswert  die  Anzahl  der  zusatzlich  verfiigbaren  Zeichensatze. 
Dieser  Wert  (z.B.  2)  wird  Elenientnummer  genannt.  Existieren  also  2 zusatzliche  Satze, 
so  hat  man  auf  einem  Bildschirm  insgesamt  3 Zeichensatze  zur  Verfiigung:  der  System- 
satz  und  die  beiden  geladenen,  Uber  die  Funktion  vst  _font  kann  einer  der  drei  Satze  ge- 
wahlt  werden.  Der  Eingabeparameter  war  aber  ein  Index,  der  zu  dem  Font  gehort.  Bisher 
hatten  wir  keine  Moglichkeit,  diesen  Index  zu  bestimmen. 


Hier  greift  die  Funktion  vqt_name  ein.  Sie  bestimmt  zu  einer  Elementnummer  den 
Index  fur  vst_font,  sowie  den  Namen  und  den  Stil  des  angegebenen  Zeichensatzes. 
Namen  konnen  sein:  „System  font",  „Swiss“,  „Dutch".  Ein  Stil  kann  sein:  „Light“, 
„Italic“  usw.  Eine  C-Beispielaufruffolge  konnte  so  aussehen: 


WORD  index,  element_nurn,  num_fonts; 

WORD  table  [11] j /*  fur  maximal  10  Fonts  */ 
BYTE  name  [32] j 


num_fonts  = vst_load_fonts  (vdi_handle,  0)  + 1; 

for  ( element_nura  = 1;  element_num  <=  num_fonts;  eleraent_num++) 

index  = vqt_name  (vdl.handle,  element_num,  name); 
table  [element.num]  = index; 
j for  */ 


vs t_ font  (vdl.handle,  table  [3]); 


Wir  nehmen  an,  daft  es  zwei  weitere  Zeichensatze  gibt,  die  „Swiss“  und  „Dutch“  heillen. 
In  obigem  Beispiel  werden  zunachst  die  Anzahl  der  insgesamt  zur  Verfugung  stehenden 
Fonts  ermittelt.  Dieser  Wert  (3)  wird  in  num_fonts  eingetragen.  Das  Beispiel  gilt  nur 
fiir  den  Bildschirm,  da  es  hier  immer  einen  Zeichensatz  mehr  gibt  (+1).  In  der  nachfol- 
genden  Schleife  wird  zu  alien  3 Satzen  der  Index  besorgt.  Man  iibergibt  alle  Nummern 
von  1 bis  3 an  die  Funktion  vqt_name  und  erhalt  die  Indizes,  die  in  dem  Feld  table  ab- 
gelegt  werden.  Die  Indizes,  die  man  bei  vqt  name  erhalt,  werden  1 (System  font),  2 
(Swiss)  und  14  (Dutch)  sein.  Nach  der  Schleife  wahlen  wir  den  Font  „Dutch“  aus.  Es 
ist  der  dritte  Font  und  an  vst_font  wird  der  Wert  14  = table  [3]  iibergeben. 


84 


2 GEM  und  sein  Umfeld 


- Gruppe  7:  Escapefunktionen 

Die  sogenannten  Escapefunktionen  dienen  dazu,  spezielle  Eigenschaften  und  Mdglichkei- 
ten  von  grafischen  Ausgabegeraten  auszunutzen.  Sie  haben  alle  die  Funktionsnummer  5 
und  eine  Unterfunktionsnummer  (subopcode).  In  nachfolgender  Tabelle  werden  nur  die 
Unterfunktionsnummern  angegeben. 


1 

_ 

vq_chcells 

2 

- 

v_exit_cur 

3 

- 

v_enter_cur 

4 

- 

v_curup 

5 

- 

v^curdown 

6 

- 

v_curright 

7 

- 

v_curleft 

8 

- 

v_curhome 

9 

- 

V eeos 

10 

- 

v_eeol 

11 

- 

vs_curaddress 

12 

- 

v_curtext 

13 

- 

v„rvon 

14 

- 

v_rvoff 

15 

- 

vq_curaddress 

16 

- 

vq  tabstatus 

17 

- 

V hardcopy 

18 

- 

v_dspcur 

19 

- 

v_rmcur 

20 

- 

V form  adv 

21 

- 

v_output„  window 

22 

- 

v_clear_disp_list 

23 

- 

v_bit_image 

24 

— 

vq_scqan 

25 

- 

v_alpha_text 

27 

- 

v_orient 

28 

- 

v_copies 

29 

- 

1 

> 

60 

- 

vs_palette 

61 

- 

v_  sound 

62 

- 

vs_mute 

81 

- 

vt_resolution 

82 

- 

vt_axis 

83 

- 

vLorigin 

84 

- 

vq_tdimensions 

85 

- 

vt_alignment 

91 

- 

vsp_film 

92 

- 

vqp_filmname 

Alphanumerische  Cursorabfragen 

Auf  Grafikraodus  schalten 

Auf  Textmodus  schalten 

Textcursor  eine  Zeile  nach  oben  setzen 

Textcursor  eine  Zeile  nach  unten  setzen 

Textcursor  eine  Spalte  nach  rechts  setzen 

Textcursor  eine  Spalte  nach  links  setzen 

Textcursor  auf  Position  0,0  bringen 

Losche  bis  zum  Ende  des  Bildschirms 

Losche  bis  zum  Ende  der  Zeile 

Setze  Textcursor  an  bestimmte  Position 

Text  an  Cursorposition  ausgeben 

Inversschrift  einschalten 

Inversschrift  ausschalten 

Position  des  Textcursors  erfragen 

Status  eines  Grafiktabletts  holen 

Bildschirm  auf  Drucker  ausgeben 

Grafikcursor  an  best.  Stelle  setzen 

Grafikcursor  Ibschen 

Seitenvorschub  ausgeben 

Teil  eines  Bildes  auf  Drucker  ausgeben 

Grafikliste  des  Druckers  loschen 

Bit-Image-Dateien  drucken 

Spezifikation  des  Druckkopfes  erfragen 

Alphanumerischen  Text  auf  Drucker  geben 

Hoch-  Oder  Querformat  einstellen 

Anzahl  Kopien  einstellen 

Papierschacht  bestimmen 

Farbpalette  einstellen 

Sound  ausgeben 

Sound  ein-/ausschalten 

Aufldsung  des  Grafiktabletts  in  Zeile/Zoll 

Aufldsung  des  Grafiktabletts  einstellen 

Ursprung  fur  Grafiktablett  einstellen 

Dimensionen  des  Grafiktabletts  bestimmen 

Ausrichtung  des  Grafiktabletts  einstellen 

Kamerafilmtyp  und  -belichtung  einstellen 

Filmnamen  fiir  Kameras  erfragen 
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93 

98 

99 
100 
101 


vsc_expose 
v_meta_extents 
v„write_meta 
vm_filename 
v_xbit_  image 


Belichtung  bei  Preview  ein-/ausschalten 
Ausdehnung  der  Grafik  in  Metadatei 
Schreibe  Element  in  Metadatei 
Anderung  des  Dateinamens  der  Metadatei 
Erweiterte  Funktion  von  v_bit_image 


Viele  der  o.g.  Funktionen  werden  nie  benutzt,  wie  z.B.  die  Funktionen  fiir  die  Ausgabe 
auf  einen  Film  oder  das  Benutzen  eines  Grafiktabletts.  Sie  werden  auch  nicht  weiter  erlau- 
tert,  da  wir  keine  Filmbelichtungsanlage  zum  Testen  zur  Verfiigung  batten.  Wir  werden 
daher  nur  noch  auf  die  Funktionen  eingehen,  die  benutzt  werden  sollten  und  die  auch  vor- 
handen  sind. 

Die  Funktionen  1-15  (vq_chcells  bis  vq_curaddress)  beziehen  sich  alle  auf  die  Aus- 
gabe des  alphanumerischen  Bildschirms.  In  der  Tat  kann  auch  auf  einem  ATARI  ST,  der 
standig  im  Grafikmodus  arbeitet,  auf  den  alphanumerischen  Schirm  umgeschaltet  werden 
(v_enter_cur).  Der  Bildschirm  wird  dabei  automatisch  geloscht  und  Textausgaben  kon- 
nen  gemacht  werden.  Z.B.  benutzt  der  VT52-Emulator  (ein  Accessory)  dieses  Feature. 


- V_HARDCOPY 


Hiermit  kann  der  Bildschirminhalt  auf  einen  Drucker  oder  ein  anderes  Gerat  ausgegeben 
werden.  Der  Druckertreiber  muh  diese  Funktion  allerdings  zur  Verfiigung  stellen. 


- V DSPCUR 

- V_RMCUR 


Diese  beiden  Funktionen  werden  vom  GEM-System  bei  der  physikalischen  Eroffnung  des 
Ausgabegerates  Bildschirm  bzw.  beim  Wechseln  vom  Grafik-  auf  Textmodus  benutzt. 
Der  Mauscursor  wird  beim  Start  des  Systems  immer  zuerst  in  der  Mitte  des  Bildschirms 
sichtbar.  Auch  ein  Umschalten  von  Text-  auf  Grafikmodus  (v_exit_cur)  laOt  ihn  wieder 
in  der  Mitte  erscheinen,  wenn  es  einen  „richtigen“  Text-  und  Grafikmodus  gibt  (nicht 
bei  ATARI  ST). 


- V_FORM_ADVANCE 


Durch  Aufruf  von  v_form_advance  kann  zwischenzeitlich  ein  Seitenvorschub  auf  dem 
Drucker  ausgegeben  werden.  Der  Seitenvorschub  wird  sofort  ausgefiihrt.  Bei  der  Funk- 
tion v_clrwk  wird  ebenfalls  ein  Seitenvorschub  ausgegeben,  aber  die  Grafik,  die  inzwi- 
schen  ausgegeben  wurde,  wird  hierbei  geloscht. 
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- V_OUTPUT_ WINDOW 

Grafiken,  die  auf  einen  Drucker  ausgegeben  werden,  werden  vom  VDI  zunachst  gepuf- 
fert.  Erst  bei  der  Funktion  v_updwk  wird  der  Puffer  geleert  und  die  Grafik  tatsachlich 
zu  Papier  gebracht.  Falls  man  sich  vor  dem  Drucken  entschlieBt,  doch  nur  einen  Teil  des 
Bildes  auszugeben,  so  kann  statt  v_updwk  auch  die  Funktion  v_output_window  ver- 
wendet  werden.  Man  gibt  ein  Fensterrechteck  an,  das  bestimmt,  welche  Telle  der  Grafik 
ausgegeben  werden  sollen. 


- V_CLEAR_DISP„LIST 

Der  Puffer,  in  dem  die  Grafikbefehle  fiir  einen  Drucker  gespeichert  werden,  wird  ge- 
Idscht,  wobei  kein  Seitenvorschub  ausgegeben  wird.  Diese  Funktion  kann  statt  v clrwk 
benutzt  werden,  bei  der  immer  ein  Seitenvorschub  ausgegeben  wird.  Ein  Beispiel  ware 
das  Unterbrechen  einer  laufenden  Grafikausgabe  mit  Loschen  des  Grafikpuffers. 


- V_ALPHA_TEXT 

Mit  Hilfe  dieser  Funktion  ist  es  moglich,  alphanumerischen  Text  auf  einem  Drucker  aus- 
zugeben. Die  angegebene  Zeichenkette  wird  nicht  im  Grafikmodus  ausgegeben,  sondern 
im  Standard-Druckerzeichensatz.  Das  WORDPLUS,  das  mit  GEM/3  mitgeliefert  wird, 
bedient  sich  dieser  Methode,  urn  Texte  auszugeben.  Es  existieren  keine  Konfigurations- 
dateien  mehr  fiir  den  Drucker  (HEX,  CFG),  vielmehr  erzeugt  WORDPLUS  eine  OUT- 
Datei  (siehe  2.7.3),  in  der  al!e  Informationen  fiir  den  Text  stehen.  Bei  der  Ausgabe  des 
Textes  auf  die  OUT  Datei  werden  auBerdem  Steuerzeichen  mitgeschrieben,  die  die  Attri- 
bute eines  Textes  (fett,  kursiv,  unterstrichen  etc.)  bestimmen. 

Diese  Steuerzeichen  fiirTextattribute  sind  von  Digital  Research  vorgeschrieben  und  wer- 
den vom  OUTPUT  an  den  Drucker  weitergeleitet.  Es  ist  Aufgabe  des  Druckertreibers, 
diese  zu  analysieren  und  auf  das  entsprechende  Textattribut  umzuschalten.  Alle  Steuerzei- 
chen werden  mit  dem  ASCII  Code  DC2  (Dezimalwert  18)  eingeleitet.  Folgende  Steuer- 
zeichen sind  definiert  und  schalten  ein  Attribut  ein  oder  aus: 

(DC2)0  - Fettschrift  ein 
(DC2)1  — Fettschrift  aus 
(DC2)2  — Kursivschrift  ein 
(DC2)3  — Kursivschrift  aus 
(DC2)4  - Unterstreichen  ein 
(DC2)5  - Unterstreichen  aus 
(DC2)6  - Superscript  ein 
(DC2)7  — Superscript  aus 
(DC2)8  - Subscript  ein 
(DC2)9  — Subscript  aus 
(DC2)A  - NLQ-Schrift  ein 
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(DC2)B  - 
(DC2)C  - 
(DC2)D  - 
(DC2)E  - 
(DC2)F  - 
(DC2)G  - 
(DC2)W  - 
(DC2)X  - 
(DC2)Y  - 
(DC2)Z  - 


NLQ-Schrift  aus 
Breitschrift  ein 
Breitschrift  aus 
Hellschrift  ein 
Hellschrift  aus 
(DC2)V  — reserviert 
Pica  ein 
Elite  ein 

Schmalschrift  ein 
Proportionalschrift  ein 


Mit  Hilfe  dieser  Steuerzeichen  ware  es  moglich,  Texte  mit  Attributen  zwischen  verschie- 
denen  Programmen  auszutauschen.  Die  Textzeile  „Dies  ist  fett  bzw.  kursiv."  muBte  dann 
so  aussehen: 


Dies  ist  (DC2)0fett(DC2)l  bzw.  (DC2)2kursiv(DC2)3. 

Eine  Textdatei,  nennen  wir  sie  „TEST.OUT“,  die  o.g.  Format  hat,  wird  tatsachlich  von 
GEM-OUTPUT  verstanden  und  korrekt  auf  dem  Drucker  ausgegeben. 


- V_ORIENT 

Diese  GEM/3-Funktion  wird  dazu  benutzt,  urn  das  Ausgabegerat  auf  eine  der  beiden  Aus- 
gabemoglichkeiten  Hoch-  oder  Querformat  (Portrait  bzw.  Landscape)  einzustellen.  Die 
Einstellung  muB  vorgenommen  werden,  bevor  irgendwelche  Ausgaben  getatigt  werden. 

Beispiel:  Mochte  man  auf  den  Drucker  eine  Grafik  im  Querformat  ausgeben,  so  muB  wie 
folgt  vorgegangen  werden  (siehe  auch  SHOWGEM.C): 

vdi.handle  = open_work  (PRINTER); 
v_orlent  (vdl.handle,  OR.LANDSCAPE) ; 

/*  Graflkausgaben. . . »/ 


- V_COPIES 

Mit  dieser  GEM/3-Funktion  kann  die  Anzahl  der  Kopien,  die  auf  einem  Drucker  gemacht 
werden  sollen,  eingestellt  werden.  Alle  Seiten  bis  zum  SchlieBen  des  Arbeitsgerates  wer- 
den in  der  spezifizierten  Anzahl  ausgegeben. 

C-Aufruf: 

count  = 3; 

v_copies  (vdl_handle,  count); 
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- V_TRAY 

Moderne  Drucker  konnen  mehrere  Einzugsschachte  fur  Einzelpapier  besitzen.  Papier 
muB  manchmal  aber  auch  manuell  eingezogen  werden.  Die  GEM/3-Funktion  v_tray  be- 
stimmt  den  Einzugsschacht,  aus  welchem  das  Papier  geholt  werden  soli.  Dabei  gelten 
folgende  Konstanten: 

— 1 : Manueller  Einzug 
0:  Default  Einzug 

1:  Erster  optioneller  Einzugsschacht 
n:  n-ter  optioneller  Einzugsschacht 

Beispiel:  Papier  soil  manuell  eingezogen  werden  (siehe  auch  VDI.H): 

vdi.handle  = open.work  (PRINTER); 
v.tray  (vdi.handle,  TRAY.MANUAL) ; 


- V_SOUND 

Diese  GEM  2.X-Funktion  kann  benutzt  werden,  urn  Tone  aus  dem  Lautsprecher  auszuge- 
ben.  Dabei  ubergibt  man  die  Frequenz  und  die  Lange  des  Tones. 

Beispiel: 

frequency  = 550; 
duration  = 3; 

v_sound  (vdi_handle,  frequenzy,  duration); 


- VS_MUTE 

Diese  GEM  2.X-Funktion  wird  benutzt,  um  den  Sound  von  v_sound  ein-  und  ausschal- 
ten  zu  konnen.  AuBerdem  kann  man  den  Status  des  Soundflags  abfragen.  Diese  Aktion 
kann  folgende  Werte  annehmen: 

— 1;  Hole  Status  des  Soundflags 
0:  Sound  einschalten 

1:  Sound  ausschalten 

Beispiel;  Sound  einschalten 
action  = 0; 

vs.mute  (vdi_handle,  action); 
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- VSP_FILM 

- VQP_FILMNAME 

- VSC_EXPOSE 

Diese  3 GEM  2.X-Funktionen  ersetzen  die  6 alien  Funktionen  fiir  die  Filmbelichtung 
(vqp_films,  vqp_state,  vsp_state,  vsp_save,  vsp_message,  vqp_error)  aus  den  GEM 
1 .X-Funktionen.  Die  neuen  Funktionen  sollen  nur  kurz  erlautert  werden. 

Mil  vsp_filni  wird  der  Filmtyp  sowie  die  Belichtungszeit  eingestellt.  Der  Aufruf  lautet: 

vsp_film  (vdi.handle,  index, . lightness) ; 

Mil  Index  wird  der  Filmtyp  angegeben.  Man  erhalt  die  gultigen  Indizes  (l..n)  iiber  die 
Funktion  vqp_filmname.  Die  Variable  lightness  kann  Werte  von  -3  bis  3 annehmen. 
Jeder  Wert  andert  die  Belichtung  urn  1/3.  D.h.  mit  dem  Wert  — 3 wird  der  Film  zur  Half- 
te  des  normalen  Wertes  belichtet,  wahrend  der  Wert  3 doppelte  Belichtungszeit  bedeutet. 

Die  Funktion  vqp_filmname  wird  verwendet,  um  die  Namen  der  Filme  zu  erhalten,  die 
belichtet  werden  konnen.  Der  Aufruf  lautet: 

BOOLEAN  status; 

WORD  index; 

BYTE  name  [25] ; 

status  = vqp_f ilmname  (vdi_handle,  index,  name); 

In  einer  Schleife  wird  man  alle  Filmnamen  erfragen,  bis  die  Variable  status  den  Wert 
FALSE  ergibt.  In  diesem  Fall  ist  der  Inhalt  von  name  die  leere  Zeichenkette. 

Beispiel:  Gib  alle  verfugbaren  Filmnamen  aus 

status  = TRUE; 
index  = 1; 

while  (status  ==  TRUE) 

[ 

status  = vqp_filmname  (vdi_handle,  index,  name); 
printf  ("Film  [iSd]  = !5s\n",  index,  name); 
index++; 

) /*  while  »/ 

Die  Funktion  vsc_expose  schaltet  die  Belichtung  ein  oder  aus.  Bei  manchen  Kameras 
kann  ein  Preview  ohne  Belichtung  durchgefiihrt  werden. 

Aufruf: 


vsc_expose  (vdi.handle,  state); 
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Die  Variable  state  kann  folgende  Werte  annehmen: 


0:  Belichtung  ausschalten 
1:  Belichtung  einschalten 


- V_META_EXTENTS 

- V^WRITE^META 

- VM_FILENAME 

- VM_PAGESIZE 

- VM_COORDS 


Die  Funktion  v meta  extents  wird  dazu  benutzt,  um  in  einer  Metadatei  ein  Rechteck 
anzugeben,  das  die  gesamte  Grafik  umgibt.  Das  Rechteck  wird  durch  die  beiden  gegen- 
iiberliegenden  Punkte  min_x,  min_y  sowie  max_x  und  max_y  angegeben.  So  kann 
ein  Zeichenprogramm,  das  Metadateien  einliest,  schnell  feststellen,  welche  Ausdehnung 
die  in  der  Metadatei  gespeicherte  Grafik  besitzt.  Die  Werte  werden  in  den  Kopf  der  Meta- 
datei eingetragen  (s.  2.7.1). 


Beispiel:  Eine  Metadatei  soli  eine  Grafikflache  von  lOOOOx  10000  Punkten  darstellen. 
In  dieser  Flache  befindet  sich  eine  Linie  mit  den  Koordinaten  xl=200,  yl=400, 
x2  = 600,  y2  =200.  Die  Ausdehnung  der  gesamten  Grafik  (hier  also  nur  der  Linie)  betragt 

min_x  = 200 
min_y  = 200 
max_x  = 600 
max_y  = 400 

Der  VDI-Aufruf  v_meta_extents  (vdi_handle,  min_x,  min_y,  max_x,  max_y)  tragt 
in  den  Kopf  der  Metadatei  die  4 Werte  ein.  Das  Programm  DUMPMETA  (s.  Kap.  2.7.1) 
gibt  eine  Metadatei  in  lesbarer  Form  aus.  Ein  weiteres  Beispiel  kann  dem  Programm 
VDITEST,  das  weiter  oben  schon  vorgestellt  wurde,  entnommen  werden. 


Die  Funktion  v_write_meta  wird  dazu  benutzt,  um  Informationen  in  die  Metadatei  zu 
schreiben,  die  nicht  durch  VDI-Funktionen  abgedeckt  sind.  Z.B.  kann GEMDRAW  meh 
rere  Objekte  (Ellipsen,  Rechtecke  etc.)  zu  einem  Objekt  zusammenfassen.  Wiirde  es  eine 
Ellipse  gefoigt  von  einem  Rechteck  in  die  Metadatei  schreiben  und  sie  dann  schlieBen, 
so  konnte  es  bei  erneutem  Einlesen  der  Datei  nicht  mehr  sagen,  daB  die  Ellipse  und  das 
Rechteck  zu  einem  Objekt  zusammengefaBt  wurden. 


Dies  kann  dadurch  verhindert  werden,  daB  GEMDRAW  zusatzliche  Informationen  in  die 
Metadatei  schreibt,  um  diese  Information  spater  wieder  zu  verwenden.  Wird  solch  eine 
Metadatei  mit  Zusatzinformationen  z.B.  iiber  OUTPUT  ausgegeben,  so  stort  es  den  Aus- 
gabetreiber  (z.B.  den  Drucker)  nicht,  daB  diese  Informationen  vorhanden  sind.  Solche 
Informationen  werden  namlich  von  alien  Treibern  einfach  ignoriert. 
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Es  konnen  also  beliebige  Zusatzinformationen  in  die  Metadatei  aufgenommen  werden. 
Diese  Informationen  konnen  Integerwerte  (intin)  und  Punktepaare  (ptsin)  sein.  Im  Feld 
intin  [0]  muB  sich  ein  benutzerdefinierter  Subopcode  befinden,  der  die  Zusatzinformation 
kenntlich  macht.  Die  Nummern  0 bis  100  sind  vom  VDI  (OUTPUT,  GEMDRAW)  reser- 
viert.  Eigene  Informationen  miissen  also  mit  der  Nummer  101  beginnen.  Das  Programm 
DUMPGEM  beriicksichtigt  alle  bekannten  Subopcodes  von  0 bis  100  und  gibt  sie  im 
Klartext  aus. 

Urn  zu  verhindern,  daC  es  Kollisionen  gibt  (verschiedene  Applikationen  benutzen  gleiche 
Subopcodes  fur  verschiedene  Informationen),  schlagen  wir  vor,  als  erstes  Objekt  einer 
Metadatei  ein  Element  mit  Subopcode  101  zu  schreiben,  das  den  Namen  und  die  Ver- 
sionsnummer  der  Applikation  angibt,  die  die  Metadatei  erzeugt  hat.  Eine  andere  Applika- 
tion,  die  die  Metadatei  einliest,  kann  feststellen,  ob  es  sich  urn  eine  fremde  oder  eine  eige- 
ne Metadatei  handelt  und  alle  weiteren  Subopcodes  ignorieren,  falls  es  sich  nicht  um  eine 
eigene  Metadatei  handelte  (die  VDI  Bindings  sind  in  Kapitel  2.5  angegeben). 


Beispiel:  Die  Versionsnummer  1.32  (GEM-Format  = 100  * Hauptversionsnummer  -I- 
Nebenversionsnummer)  und  der  Name  der  Applikation  (z.B.  TEST)  soil  in  eine  Meta- 
datei geschrieben  werden. 

WORD  version; 

BYTE  app_name  [80] ; 

version  = 132; 

strcpy  (app_name,  "TEST"); 


Intln  [0]  = 101;  /*  Subopcode  ftir  Version  und  Appname  */ 
intin  [1]  = version; 

for  (1  = 0;  i < strlen  (app_narae);  i-i-i-)  int_ln  [i+2]  = app_narae  [i]; 
v_wrlte_raeta  (vdi_handle,  strlen  (app_name)  -i-  2,  intin,  0,  ptsin) ; 

Die  Lange  des  intin-Feldes  ergibt  sich  aus  der  Lange  der  Zeichenkette  app_name  plus 
2 (Subopcode  101,  Versionsnummer  1.32). 

Die  Funktion  vm_filename  wird  dazu  benutzt,  den  Namen  einer  Metadatei  festzulegen. 
Wird  eine  Arbeitsstation  als  Metadatei  geoffnet,  so  benutzt  der  Metadatei-Treiber  stan- 
dardmaBig  die  Datei  GEMFILE.GEM,  wenn  Ausgaben  auf  diese  Arbeitsstation  getatigt 
werden.  Da  man  aber  meistens  in  eine  Datei  mit  einem  anderen  Namen  schreiben  mochte, 
kann  dieser  umdefmiert  werden.  Man  sollte  diese  Funktion  sofort  nach  dem  Offnen  der 
Arbeitsstation  aufrufen  (siehe  auch  VDITEST). 

Beispiel:  Es  soli  in  die  Datei  „TEST.GEM“  geschrieben  werden.  Der  Aufruf  heiBt 


vm_filename  (vdl_handle,  "TEST"); 
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Die  beiden  Funktionen  vm_pagesize  bzw.  vm_coords  sind  erst  ab  der  GEM- Vers  ion 
2.x  direkt  verfiigbar.  Sie  werden  dazu  benutzt,  in  einer  Metadatei  die  Seitengrofie  bzw. 
das  Koordinatensystem  fur  diese  GroBe  einzustellen.  Aus  dem  Koordinatensystem  und 
der  SeitengrdBe  ergibt  sich  dann  die  PixelgroBe  der  Punkte  in  einer  Metadatei. 

Die  beiden  Funktionen  werden  auf  einem  ATARI  ST  mit  Hilfe  des  direkten  Aufrufs  des 
VDI  nachgebildet  und  sind  dann  mit  dem  gleichen  Namen  verfiigbar  (siehe  auch 
VDITEST). 

Die  SeitengroBe  wird  in  1/10  mm  angegeben.  Die  Breite  und  die  Hohe  einer  Seite  konnen 
getrennt  eingestellt  werden.  Damit  ist  es  auch  mdglich,  Grafiken  im  Querformat  zu  erstel- 
len  (Breite  groBer  als  Hohe).  Der  C-Aufruf  sieht  wie  folgt  aus; 

WORD  pgwidth,  pghelght; 

vm_pagesi2e  (vdl.handle,  pgwidth,  pghelght); 

Bei  der  Angabe  des  Koordinatensystems  miissen  die  x-  und  y-Werte  der  linken  unteren 
und  die  x-  und  y-Werte  der  rechten  oberen  Ecke  angegeben  werden.  Dabei  muB  beachtet 
werden,  in  welchem  Koordinatentyp  (NDC  oder  RC)  man  die  Metadatei  geoffnet  hat. 
Entsprechend  mussen  die  y-Werte  verdreht  werden  (s.a.  VDITEST).  Der  C-Aufruf  sieht 
dann  so  aus: 


WORD  llx,  lly,  urx,  ury; 

vm^coords  (vdl_handle,  llx,  lly,  urx,  ury); 


llx:  low  left  X 


ury;  upper  right  y 


Beispiel:  Wir  erstellen  eine  quadratische  Grafik  im  RC-System  mit  einer  SeitengroBe  von 
5x5  cm.  Pro  Zentimeter  sollen  10  Punkte  gesetzt  werden  konnen  (also  millimetergenau), 
wobei  auf  der  x-  und  y-Achse  jeweils  50  Punkte  (mit  Koordinatenwerten  0 bis  49)  gesetzt 
werden  konnen.  Danach  soil  eine  horizontale  Linie  mit  3,5  cm  Lange  ausgegeben  werden 
(z.B.  von  Punkt  0,0  nach  Punkt  34,0). 

WORD  pgwidth,  pghelght; 

WORD  llx,  lly,  urx,  ury; 

WORD  pxy  [4]; 

pwidth  = 500;  /*  5 cm  = 500/10  mm  */ 
phelght  = 500; 

llx  = 0; 

lly  =49;  /*  50  Punkte  pro  5 cm  = 1 Punkt/mm  */ 
urx  = 49; 
ury  = 0; 


pxy  [0]  = 0;  /*  xl  */ 
pxy  [1]  = 0;  /*  yl  */ 
pxy  [2]  = 34;  /*  x2  */ 
pxy  [3]  = 0;  /*  y2  */ 


2.3  VDI 


93 


vdi_handle  = open_work  (METAFILE,  RC); 
vm.pagesize  (vdl_handle,  pgwidth,  pgheight); 
vni_coords  (vdi_handle,  llx,  lly,  urx,  ury) ; 
v_pline  (vdi_handle,  2,  pxy) ; 
close_work  (METAFILE); 

Man  beachte,  dali  die  Eckpunkte  des  Koordinatensystems  im  Wert  immer  um  1 vermin- 
dert  sind,  da  sich  die  Anzahl  der  Punkte  einer  Achse  (z.B.  x-Achse)  zu  urx  — llx  + 1 
berechnen.  Ebenso  berechnet  sich  die  Lange  einer  horizontalen  Linie  zu  x2  — xl  + 1, 
was  in  obigem  Beispiel  einen  Wert  von  35  ergibt.  Ein  Pixel  in  oben  erzeugter  Metadatei 
entspricht  1 mm  Breite  bzw  Hohe. 

- V_BIT_IMAGE 

- V_XBIT_IMGAGE 

Bit-Image-Dateien  sind  Dateien  mit  Suffix  IMG,  die  komprimierte  Pixelgrafiken  enthal- 
ten.  Der  Algorithmus  mag  nicht  das  kompakteste  Format  erzeugen,  aber  geniigt,  um  Pi- 
xelgrafiken platzsparend  zu  speichern.  Deshalb  sollte  jedes  Programm,  welches  Pixelgra- 
fiken erzeugen  kann,  mindestens  das  GEM  Bit-Image-Format  einlesen  und  speichern  kon- 
nen.  Nur  dann  konnen  alle  Grafikpakete  Daten  miteinander  austauschen. 

Ein  weiterer  Vorteil  beim  Benutzen  von  Bit-Image-Dateien  ist  die  Leichtigkeit,  diese  auf 
einem  Drucker  oder  anderen  Geraten  (auBer  Bildschirm)  auszugeben.  Ein  einziger  VDI- 
Befehl  (v_bit_image  oder  v_xbit_  image)  druckt  die  gesamte  Grafik. 

Die  Funktion  v_bit_image  druckt  die  angegebene  Datei  auf  das  Ausgabegerat.  Dabei 
kann  das  x-y-Verhaltnis  (aspect  ratio)  beibehalten,  die  Grafik  horizontal  und  vertikal  aus- 
gerichtet  sowie  die  Skalierung  angegeben  werden.  Ein  Rechteck,  in  das  die  Grafik  passen 
muB,  kann  ebenfalls  angegeben  werden.  Der  C-Aufruf  sieht  wie  folgt  aus: 

v_bit_image  (vdl_handle,  filename,  aspect,  x_scale,  y_scale, 
h.align,  v_allgn,  xyarray) ; 

Dabei  haben  die  Variablen  folgende  Bedeutung: 

Die  Variable  filename  enthalt  den  Dateinamen  der  IMG-Datei. 

Aspect  kann  folgende  Werte  annehmen: 

0 = Ignoriere  x-y-Verhaltnis 

1 = Behalte  x-y-Verhaltnis  bei 

Wird  das  x-y-Verhaltnis  beibehalten,  so  erseheinen  Kreise  als  Kreise,  Quadrate  als  Qua- 
drate usw.  Das  Bild  wird  auf  dem  Ausgabegerat  dann  entsprechend  gedehnt.  Dies  kann 
unter  Umstanden  schlecht  aussehen,  wenn  z.B.  feine  Punktraster  gedehnt  oder  gestaucht 
werden.  Wird  das  Verhaltnis  ignoriert,  so  konnen  aus  Kreisen  auch  Ellipsen  werden. 
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Die  anderen  Parameter  beziehen  sich  auf  das  Rechteck,  in  das  die  Grafik  hineinpassen 
soil. 

Die  Werte  x_scale  und  y_scale  geben  an,  ob  eine  VergroJlerung  oder  Verkleinerung 
auf  den  jeweiligen  Achsen  ganzzahlig  oder  in  Briichen  durchgefiihrt  werden  soil.  Dabei 
bedeuten: 

0 = Skalierung  mit  Briichen 

1 = Ganzzahlige  Skalierung 

Bei  einer  Skalierung  mit  Briichen  paBt  das  Bild  in  das  angegebene  Rechteck  in  jedem  Falle 
hinein  und  wird entsprechend  gestaucht  oder  gedehnt  (z.B.  umden  Faktor2.5).  Dies  kann 
aber  bei  feinen  Mustern  schlecht  aussehen,  da  man  aus  einem  Pixel  in  der  Grafik  nicht 
2.5  Pixel  auf  einem  Drucker  machen  kann.  Bei  der  Skalierung  mit  ganzen  Zahlen  kann 
dies  nicht  passieren.  Dort  werden  z.B.  aus  einem  Pixel  3 Druckerpixel,  wenn  eine  Ver- 
grdlierung  um  den  Faktor  3 stattfindet.  Feine  Muster  erscheinen  dann  auch  noch  sauber. 

Skaliert  man  ganzzahlig,  so  kann  es  sein,  daB  das  Bild  nur  so  skaliert  werden  kann,  daB 
es  im  angegebenen  Rechteck  noch  viel  Platz  gibt.  1st  das  Rechteck  z.B.  2.5  mal  so  groB 
wie  das  Bild  und  skaliert  man  ganzzahlig,  so  wird  nur  um  den  Faktor  2 skaliert.  Das  Bild 
kann  dann  mittels  der  Variablen  h_align  und  v_align  in  diesem  Rechteck  plaziert  wer- 
den. Dabei  kdnnen  folgende  Werte  auftreten: 

Ausrichtung  horizontal: 
h_align:  0 = links 

1 = zentriert 

2 = rechts 

Ausrichtung  vertikal: 
v„align:  0 = oben 

1 = mine 

2 = unten 

Die  Funktion  v_xbit_image  steht  ab  GEM/3  zur  Verfiigung.  Damit  ist  es  moglich,  Bit- 
Image-Dateien  rotiert  ausgeben  zu  lassen.  AuBerdem  kann  die  Hinter-  und  Vordergrund- 
farbe  angegeben  werden,  wenn  eine  monochrome  Bit-Image-Datei  auf  einem  Farb- 
drucker  ausgegeben  werden  soil.  Der  C-Aufruf  sieht  wie  folgt  aus: 

v_xbit_image  (vdi_handle,  filename,  aspect,  x.scale,  y_scale, 

h_align,  v_align,  rotate,  background,  foreground,  xy) ; 

Die  Varible  rotate  gibt  die  Drehung  der  Grafik  an.  Meist  ist  nur  ein  Drehen  in  90-Grad- 
Schritten  moglich  (vq_extnd  gibt  Auskunft  dariiber). 

Die  Variablen  background  sowie  foreground  enthalten  den  Farbindex  (z.B  3 = Rot)  des 
Hintergrundes  bzw.  des  Vordergrundes,  mit  dem  die  Grafik  ausgegeben  werden  soil,  falls 
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es  sich  um  eine  einfarbige  Grafik  (Anzahl  Farbebenen  = 1)  handelt. 


Weitere  Informationen  iiber  den  Aufbau  einer  Bit-Image-Datei  befinden  sich  in  Kapitel 
2.7.2. 


— Hinweise  fiber  zukfinftige  Funktionen: 

Ab  GEM/3  Version  3.11  existieren  weitere  VDI-Funktionen,  die  sich  mit  Bezier- 
Funktionen  und  Postscript  Druckern  beschaftigen.  Bezier-Kurven  und  -Flachen  kdnnen 
durch  die  Angabe  von  Stutzstellen  gezeichnet  werden.  Das  Programm  ARTLINE  macht 
mit  seinen  Vektorfonts  Gebrauch  von  diesen  neuen  Funktionen.  Da  sie  aber  offiziell  im 
Programmer’s  Toolkit  noch  nicht  dokumentiert  sind,  werden  sie  in  einer  spateren  Auflage 
beschrieben.  Fiir  Interessierte  befinden  sich  auf  der  Diskette  das  Bezier-Beispiel 
BEZIER. GEM.  Es  handelt  sich  um  eine  Bezier-Kurve.  Man  kann  sich  die  Metadatei  mit 
dem  Programm  DUMPGEM  anschauen,  um  die  neuen  Funktionen  zu  erkennen.  Man 
kann  die  Datei  auch  fiber  das  OUTPUT  ausgeben,  wobei  die  Bezier-Kurve  natfirlich  nur 
mit  Polygonzugen  angenahert  wird. 


- Zusammenfassung  VDI: 

Wir  haben  erfahren,  welche  Rolle  das  VDI  im  GEM  und  im  Betriebssystem  eines  Rech- 
ners  spielt.  AuBerdem  stellt  das  VDI  eine  groBe  Menge  grafischer  Funktionen  zur  Verffi- 
gung,  die  von  Linienzeichnen  (v_polyline)  bis  zum  kompletten  Ausdruck  von  Pixelgra- 
fiken  (v_bit_image)  reichen.  Mit  diesen  Funktionen  ist  es  moglich,  Grafiken  auf  unter- 
schiedlichen  Geraten  auszugeben,  ohne  daB  dies  fur  jedes  Gerat  neu  programmiert  wer- 
den muB.  Dabei  fibernahmen  die  Treiber  der  Ausgabegerate  (workstations)  die  Funktion, 
jede  fiber  das  VDI  ankommende  Grafik  auf  dem  entsprechenden  Gerat  in  optimaler  Quah- 
tat  auszugeben. 

Wir  lernten  auBerdem  die  Rolle  der  Datei  ASSIGN. SYS  bzw.  der  GEM/3-Funktion 
v_get_driver_info  kennen,  die  Geriitenummern,  Treiber  und  Zeichensatze  der  Gerate 
verbindet  und  wie  die  interne  Kommunikation  mit  dem  VDI  ablauft  (contrl,  intin  Felder 
je  nach  Funktionsart  ffillen). 

Am  Ende  dieses  Abschnitts  wurden  dann  alle  wichtigen  VDI-Funktionen  genau  erlautert. 
Dort  wurde  gezeigt,  wie  man  Zeichensatze  ladt  und  die  Indizes  zum  Auswahlen  der  Satze 
bekommt.  Rasterfunktionen  wurden  genau  erlautert,  da  das  Benutzen  dieser  Funktionen 
die  einzige  hardwareunabhiingige  Moglichkeit  darstellt,  Bildschirminhalte  zu  scrollen 
bzw.  zu  kopieren.  Das  Format  eines  Grafikblockes  spielte  dort  eine  wichtige  Rolle  ffir 
die  Behandlung  von  Icons  (Umwandlung  Standardformat  <->  geratespezifisches 
Format). 

SchlieBlich  wurde  gezeigt,  wie  man  Metadateien  erstellt  (VDITEST)  und  wir  erfuhren, 
daB  das  Benutzen  von  Metadateien  die  einzige  saubere  Moglichkeit  ist,  Vektorgrafiken 
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(nur  mit  VDI-Befehlen  erzeugt)  zwischen  verschiedenen  Programmen  auszutauschen. 
Das  Austauschen  dieser  Grafiken  ist  nicht  nur  programmunabhangig,  sondern  auch  rech- 
nerunabhangig.  Metadateien  sind  z.B.  zwischen  MS-DOS-  und  ATARI-Rechnern  belie- 
big  austauschbar. 


2.4  AES 

Nachdem  wir  im  letzten  Kapitel  das  VDI  kennengelernt  haben  und  nun  wissen,  wie  man 
Grafik  auf  einem  Bildschirm  erzeugt,  werden  wir  in  diesem  Kapitel  auf  die  zweite  wichti- 
ge  Komponente  des  GEM  eingehen.  Es  handelt  sich  urn  das  AES  (Application  Environ- 
ment Services),  welches  sich  in  12  Funktionsgruppen  aufteilt.  Die  Funktionen  in  diesen 
Gruppen  dienen  dazu,  einem  Anwendungsprogrammierer  das  Erzeugen  von  AES- 
Komponenten  zur  Verfiigung  zu  stellen.  Komponenten  des  AES  sind  Bildschirmfenster, 
Meniizeilen,  Drop-Down-Meniis,  Ereignissteuerung  durch  eine  Maus,  Formularverwal- 
tung  (sogenannte  Dialogboxen)  und  andere  Funktionen. 

Jeder,  der  schon  einmal  mit  einem  GEM-Programm  gearbeitet  hat,  weiB,  was  mit  Dialog- 
boxen, Fenstern  und  Menus  gemeint  ist.  Wir  gehen  davon  aus,  dal)  ein  GEM-Entwickler 
mindestens  ein  GEM-Programm  (z.B.  den  DESKTOP)  gut  kennt  und  bedienen  kann.  Da- 
her  ersparen  wir  uns  langwierige  und  langweilige  Einfuhrungen  und  konzentrieren  uns 
auf  die  wesentlichen  und  interessanten  Aspekte  der  GEM-AES-Programmierung.  Auch 
werden  wir  nur  auf  solche  AES-Funktionen  genauer  eingehen,  die  in  anderen  Buchern 
gar  nicht  oder  falsch  erlautert  wurden  und  solche,  die  in  neueren  GEM-Versionen  hinzu- 
gekommen  sind. 

Grundsatzlich  gibt  es  2 Arten  von  GEM-Programmen:  Applikationen  und  Desk- 
Accessories.  Der  Unterschied  ist  aber  nur  gering.  Applikationen  werden  per  Mausklick 
vom  GEM-Desktop  aus  gestartet  und  laufen  dann  im  Vordergrund  als  Hauptapplikation 
ab.  Desk  Accessories  werden  beim  Start  des  GEM-Systems  geladen,  bleiben  resident  im 
Speicher  und  laufen  im  Hintergrund  quasi  parallel  ab.  Beispiele  sind:  Uhr,  Druckerspoo- 
ler,  Kontrollfeld  usw.  Sie  konnen  von  jedem  GEM-Programm  aus  aktiviert  werden.  Die 
Programmierung  und  Handhabung  ist  aber  bei  beiden  Programmtypen  gleich.  Im  Bei- 
spielprogramm  in  Kapitel  6 wird  gezeigt,  wie  ein  Programm  gleichzeitig  als  Applikation 
Oder  als  Accessory  benutzt  werden  kann. 


2.4,1  Speicherbelegung 

Das  AES  setzt  auf  dem  VDI  und  dem  Betriebssystem  auf  und  kann  daher  nicht  ohne  VDI 
benutzt  werden  (im  Gegensatz  dazu  kann  das  VDI  ohne  das  AES  gestartet  werden).  Wird 
beispielsweise  ein  Fenster  gezeichnet,  so  werden  Linien  und  Fiillmuster,  sowie  Textaus- 
gaben  iiber  das  VDI  gemacht. 

Die  folgende  Abbildung  soli  verdeutlichen,  wie  das  GEM-System  im  Speicher  liegt,  wenn 
eine  GEM- Applikation  gestartet  wird. 
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Speicherplatz 
fiir  Applikation 


AES 

VDI  besteht  aus 
GDOS,  Treibern 
und  Ze i c hensatzen 


Treibep  und 
Zeichensatze 


Appl ikation 


Desk  Accessories 


Menii-  und  Alertpuffer 


Bildschi rnnanager 
D i spate  her 


Kern 


GDOS 


Betriebssysten 


Abb.  2.10:  Speicheraufteilung  einer  GEM-Applikation 


Wie  man  sieht,  liegt  das  GEM-System  (GDOS,  Kernel,..., Alertpuffer)  standig  im  Spei- 
cher.  Der  Menii-  und  Alertpuffer  wird  dazu  benotigt,  den  Bildschirmhintergrund  zu  ret- 
ten,  wenn  ein  Menii  herunterklappt  bzw.  wenn  eine  Alertbox  erscheint. 

Dariiber  liegen  alle  geladenen  Desk- Accessories.  Der  Rest  des  Speichers  bleibt  frei  fiir 
GEM-Applikationen.  Eine  GEM-Applikation  kann  mittels  v_opnwk  bzw.  vst^load 
„fonts  Treiber  bzw.  Zeichensatze  nachladen,  die  dann  oberhalb  der  Applikation  im 
Speicher  Platz  finden. 


2,4.2  AES  Komponenten 

Das  AES  besteht  aus  einem  Kern,  der  die  AES-Funktionen  bereitstellt,  dem  Bildschirm- 
manager,  einem  Dispatcher  sowie  einem  Menu-  und  einem  Alert-Puffer.  Alle  AES- 
Funktionen  werden  sofort  beim  Aufruf  ausgefiihrt.  Ausnahmen  bilden  die  Funktionen  aus 
der  Ereignis-Bibliothek  (Events).  Ein  Aufruf  solch  einer  Funktion  veranlafit  den  Dispat- 
cher auf  einen  anderen  ProzeJi  umzuschalten.  Prozesse  in  einem  GEM-System  sind: 
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a)  die  Hauptapplikation 

b)  eines  der  Desk-Accessories  (bis  zu  6 Stuck) 

c)  der  Bildschirmmanager 

Diese  Prozesse  laufen  alle  parallel  ab,  so  da6  auf  einem  Einprozessor-System  standig  zwi- 
schen  ihnen  bin-  und  hergeschaltet  werden  muB. 

Der  Bildschirmmanager  ist  ein  Hintergrund-ProzeB,  der  die  Bildschirmverwaltung  sowie 
Tastatur-  und  Mauseingaben  steuert  und  immer  dann  aktiv  wird,  wenn  die  Maus  folgende 
Bereiche  betritt: 

a)  die  Meniizeile  und  Drop-Down-Meniis 

b)  Xitel-  und  Informationszeile  eines  Fensters 

c)  Randkomponenten  eines  Fenster  (z.B.  Schieber) 

Da  GEM  bisher  nur  auf  Einprozessor-Systemen  implementiert  wurde,  kann  es  kein  echtes 
Multitasking  geben,  d.h.  der  Dispatcher  hat  keine  Moglichkeit,  zwischen  o.g.  Prozessen 
umzuschalten.  Dies  kann  er  nur  dann,  wenn  Programme  AES-Aufrufe  tatigen.  Hangt 
z.B.  ein  Programm  in  einer  Endlosschleife,  in  der  kein  AES-Aufruf  erfolgt,  so  hangt  das 
ganze  System.  Deshalb  sollten  in  Programmschleifen,  in  denen  nur  gerechnet  wird,  ab 
und  zu  AES-Aufrufe  getatigt  werden.  Die  Funktion  appl  yield  gibt  dem  Dispatcher  die 
Moglichkeit  auf  einen  anderen  ProzeB  umzuschalten.  Andere  Prozesse,  z.B.  ein  Drucker- 
Spooler  als  Desk- Accessory,  kdnnen  dann  noch  aufgerufen  werden  bzw.  konnen  weiter- 
laufen,  obwohl  das  Hauptprogramm  hangt.  AuBerdem  wird  die  Zeit  zwischen  den  Prozes- 
sen gerechter  verteilt,  wenn  jeder  ProzeB  hin  und  wieder  seine  Aktivitat  durch  den 
appl_yield-Aufruf  hinten  anstellt. 


2.4.3  AES-Funktionsgruppen 

Die  o.g.  Funktionsgruppen  sind  in  einzelnen  Bibliotheken  (Libraries)  abgelegt.  Der 
Name  der  Bibliothek  wird  in  Englisch  gehalten,  damit  man  auch  mit  den  Originalentwick- 
lungsunterlagen  von  Digital  Research  keine  Probleme  hat,  wenn  man  Funktionen  nach- 
schlagen  muB.  Der  Inhalt  der  Bibliotheken  sind: 


Bibliothek  Kurzbeschreibung 


Application 

Initialisierung  und  Kommunikation 

Event 

Eingabe-  und  Ereignisbehandlung 

Menu 

Verwaltung  der  Meniizeile 

Object 

Verwaltung  von  Dialogboxen 

Form 

Eingabeverwaltung  von  Dialogboxen 

Graphics 

Rechteckverwaltung 

Scrap 

Verwaltung  fiir  Datenaustausch 

File  Selector 

Dateiauswahl 

Window 

Fensterverwaltung 
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Resource  Resourceverwaltung 

Shell  Verwaltung  von  Informationen  der  Shell 

Extended  Graphics  Weitere  Rechteckfunktionen 


Um  einen  besseren  Uberblick  iiber  die  Funktionen  des  AES  zu  bekommen,  sollen  die  ein- 
zelnen  Funktionsgruppen  kurz  erlautert  werden. 


- Application-Library 

In  dieser  Bibliothek  sind  Funktionen  enthalten,  um  eine  GEM-Applikation  zu  initialisie- 
ren  und  zu  terminieren.  Aber  auch  die  Kommunikation  mit  anderen  Programmen  und  Ac- 
cessories kann  damit  vorgenommen  werden  (Senden  und  Empfangen  von  Nachrichten). 
Ab  GEM  2.x  kann  auBerdem  die  Konfiguration  der  angeschlossenen  Laufwerke  be- 
stimmt  werden. 


— Event-Library 

GEM-Programme  sind  ereignisgesteuert,  d.h.  ein  Programm  wartet  an  einer  bestimmten 
Stelle  auf  das  Eintreten  von  Ereignissen,  die  dann  abgehandelt  werden.  Ereignisse  konnen 
Mausklicks,  Tastendrucke,  Mausbewegungen,  Zeitintervalle  oder  auch  Nachrichten 
(vom  GEM  System  oder  anderen  Applikationen)  sein.  Fur  die  Abhandlung  von  Ereignis- 
sen stehen  die  Funktionen  der  Ereignis-Bibliothek  zur  Verfiigung. 


— Menu-Library 

Meniizeilen  in  GEM-Programmen  erscheinen  am  oberen  Bildschirmrand.  Die  Menii- 
Bibliothek  stellt  Funktionen  zur  Verfiigung,  um  Menuzeilen  anzuzeigen,  einzelne  Menii 
titel  grau  (schwach)  darzustellen  und  Hakchen  (check  markers)  vor  einen  Meniititel  zu 
stellen.  AuBerdem  konnen  in  das  Accessory -Menii  Eintrage  aufgenommen  werden,  sowie 
Texte  von  Meniieintragen  verandert  werden. 
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Abb.  2.11:  Meniizeile  eines  GEM-Programmes 


— Object-Library 

Die  Funktionen  der  Objekt-Biicherei  sind  wichtig  fiir  das  Verwalten  von  Objektbaumen 
(Dialogboxen).  Ein  einziger  Befehl  zeichnet  eine  komplette  Dialogbox  Oder  findet  ein  Ob- 
jekt  einer  Dialogbox,  welches  sich  unter  dem  Mauszeiger  befmdet. 

— Form-Library 

Zusammen  mit  der  Objekt-Biicherei  iibernimmt  die  Formular-Biicherei  weitere  Verwal- 
tungsarbeit  fiir  Dialogboxen.  So  kann  mit  einem  einzigen  Befehl  die  komplette  Abarbei- 
tung  eines  Dialoges  gemacht  werden.  Aber  auch  Fehlermeldungen  konnen  elegant  ausge- 
geben  werden. 
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Eintrag  - Info 
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Kundennr.j.- 

— 

Typ  : 

Text 
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KUNDENNR 

It 
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"~|  1 Rbbruchl 

Abb.  2.12:  GEM-Dialogbox  (Formular) 


Diese  Rnivendung  kann  das 
angegebene  Objekt  nicht 
f inden. 


[ZED 


Abb.  2.13:  GEM-Fehlermeldung 


— Graphics-Library 

In  der  Grafik-Bibliothek  findet  man  Funktionen  fiir  die  Verwaltung  von  Rechtecken.  So 
kann  ein  Rechteck  gezogen  werden,  das  sich  mil  dem  Mauszeiger  automatisch  mitbewegt, 
Oder  Rahmen  konnen  mit  der  Mans  erstellt  werden  (z.B.  das  Einrahmen  von  Dateien  auf 
dem  Desktop).  Die  Mausform  kann  verandert  oder  ganzlich  abgeschaltet  werden. 


— Scrap-Library 

Die  Scrap-Bibliothek  wurde  in  den  meisten  GEM-Programmen  sehr  stiefmiitterlich  be- 
handelt.  Mit  Hilfe  dieser  Funktionen  ist  es  moglich,  den  Datenaustausch  zwischen  Pro- 
grammen  zu  standardisieren.  Deshalb  wird  in  Kapitel  2.4.4  genau  darauf  eingegangen. 
Das  Beispielprogramm  aus  Kapitel  6 ist  eine  komplette  Implementierung  eines  Klemm- 
brettes,  welches  auch  als  Accessory  verwendet  werden  kann. 
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Abb.  2.14:  Inhaltsverzeichnis  des  GEM-Klemnnbrettes 


— File-Selector-Library 

Die  Dateiauswahl-Bibliothek  besteht  nur  aus  einer  Funktion.  Sie  wird  aber  in  jedem 
GEM-Programm  benutzt,  bei  denen  Dateien  geladen  oder  gespeichert  werden  sollen.  Der 
Aufruf  dieser  Funktion  stellt  eine  Dialogbox  zur  Verfugung,  in  der  der  Benutzer  die  In- 
haltsverzeichnisse  aller  angeschlossenen  Laufwerke  bzw.  Partitionen  der  Festplatte  nach 
Dateinamen  durchforsten  kann. 


— Window- Library 

Die  Fenster-Bibliothek  stellt  die  wichtigsten  Funktionen  einer  GEM-Applikation  zur  Ver- 
fugung. Mit  ihnen  konnen  Fenster  kreiert,  geoffnet  und  geschlossen  werden.  Auch  die 
Randkomponenten  eines  Fensters  konnen  bestimmt  werden,  also  ob  ein  Fenster  sog. 
Schieber  hat  oder  ob  es  vergroBert/verkleinert  werden  darf.  Auch  der  Name  des  Fensters 
kann  gesetzt  werden. 
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Abb.  2.15:  GEM-Fenster  mit  Komponenten 
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— Resource-Library 

Unter  Resourcen  einer  GEM-Applikation  werden  alle  Teile  des  Programmes  verstanden, 
die  geandert  werden  miissen,  wenn  das  Programm  z.B.  in  eine  andere  Sprache  iibersetzt 
werden  soil.  GEM-Applikationen  werden  also  iiblicherweise  getrennt  in  den  reinen  Pro- 
grammteil  und  den  Resourceteil.  In  den  Resource-Dateien  befinden  sich  Meniileisten  und 
Drop-Down-Meniis,  Dialogboxen  und  Fehlermeldungen,  Piktogramme  oder  einfach  freie 
Texte.  Mil  den  Funktionen  der  Resource-Bibliothek  konnen  die  Resourcen  geladen  wer- 
den und  die  Adressen  der  einzelnen  Objekte  zum  spateren  Gebrauch  geholt  werden. 
Resource-Dateien  enden  mit  dem  Suffix  RSC  und  konnen  mit  dem  sogenannten  Resource- 
Construction-Set  erzeugt  werden. 


- Shell-Library 

Die  Shell-Bibtiothek  wird  dazu  benutzt,  Informationen  aus  der  Programmumgebung  zu 
lesen  oder  solche  Informationen  zu  schreiben. 

Auch  das  Aufrufen  von  anderen  Programmen  aus  einem  GEM-Programm  heraus  ist  mog- 
lich.  Welches  Programm  beim  Verlassen  eines  aufgerufenen  Programmes  gestartet  wer- 
den soli,  kann  ebenfalls  bestimmt  werden.  Im  Normalfall  wird  es  der  GEM-Desktop  sein. 


- Extended-Graphics-Library 

Die  Funktionen  aus  der  erweiterten  Grafik-Bibliothek  sind  ab  GEM  2.X  verfugbar  und 
ersetzen  die  Funktionen  graf_growbox  und  graf_shrinkbox.  Mit  Hilfe  der  beiden 
Funktionen  ist  es  mdglich,  ein  sich  ausdehnendes  oder  ein  schrumpfendes  Rechteck  zu 
zeichnen. 


2.4.4  Kommunikation  mit  dem  AES 

Alle  GEM-Programme  nutzen  das  AES,  das  alle  notigen  Funktionen  fur  die  Erstellung 
von  Anwendungsprogrammen  bietet,  um  eine  moderne  Benutzerschnittstelle  zu  schaffen. 
Fiir  Programme,  die  in  einer  hoheren  Programmiersprache  geschrieben  sind,  erfolgt  die 
Nutzung  des  AES  einfach  durch  den  Aufruf  der  Funktionsnamen. 

Assembler-Programmierer  haben  es  da  schwerer.  Sie  miissen  verschiedene  Strukturen 
beachten,  um  die  Parameter  an  das  AES  zu  liefern.  Obwohl  es  kaum  Sinn  macht,  AES- 
Befehle  in  Assembler  zu  nutzen,  soil  die  Parameteriibergabe  doch  erklart  werden. 

Das  AES  wird  iiber  ein  einziges  Unterprogramm  aufgerufen,  dem  6 Parameter  iibergeben 
werden.  Es  handelt  sich  um  6 Felder  (arrays),  wobei  der  Grundtyp  eines  Feldes  aus  einem 
Rechnerwort  oder  Langwort,  also  16  oder  32  Bit  bestehen  muB.  Die  Felder  werden  wie 
folgt  benannt; 
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— control  (Funktionsangabe) 

— global  (globale  Informationen  wie  z.B.  GEM  Version) 

— int_jn  (ganzzahlige  Eingaben) 

— int_out  (ganzzahlige  Ausgaben) 

— addr_in  (Eingabe-Adressen,  Grundtyp  LONG) 

— addr  out  (Ausgabe-Adressen,  Grundtyp  LONG) 

EXTERN  WORD  control  []; 

EXTERN  WORD  global  []; 

EXTERN  WORD  int„in  []; 

EXTERN  WORD  int_out  []; 

EXTERN  LONG  adr_in  []; 

EXTERN  LONG  adr_out  []; 

EXTERN  bedeutet  in  diesem  Zusammenhang,  dafi  die  Felder  beim  Compilerlauf  votn 
Programmierer  benutzt  werden  kdnnen  (definiert  sind  sie  in  den  AES-Bindings).  WORD 
bedeutet  16-Bit-Werte,  LONG  32-Bit-Werte.  Die  Bedeutung  solcher  Portabilitats- 
Makros  wird  in  Kapitel  3 erklart. 

Die  o,g.  Felder  werden  beim  Aufruf  der  AES-Funktionen  von  hoheren  Programmierspra* 
chen  aus  automatisch  von  den  sogenannten  AES-Bindings  gefullt.  Die  Felder  enthalten 
folgende  Informationen: 


a)  control 


control  [0] 
control  [1] 
control  [2] 
control  [3] 
control  [4] 


= Funktionsnummer 
= Anzahl  der  Elemente 
= Anzahl  der  Elemente 
= Anzahl  der  Elemente 
= Anzahl  der  Elemente 


im  Feld  int_ln 
im  Feld  int_out 
im  Feld  adr_in 
im  Feld  adr^out 


b)  global 


Dieses  Feld  wird  beim  Aufruf  der  Funktion  appl_init  automatisch  gefullt. 


global  [ 0] 
global  [ 1] 
global  [ 2] 
global  [ 3] 
global  [ 5] 
global  [ 7] 

global  [ 9] 
global  [10] 
global  [11] 


= GEM  Versionsnummer 

= Vordergrundapplikationen,  die  gleichzeitig  ablaufen  konnen. 

= eindeutiger  Bezeichner  fiir  die  Applikation  (gl_apid) 

— global  [4]  = ob_spec  von  Fenster  0 

— global  [6]  = Zeiger  auf  Basisbaume  der  geladenen  Resource-Datei 

— global  [8]  = Zeiger  auf  Adresse,  an  der  die  Resource-Datei  geladen 
wurde 

= Lange  der  zuletzt  geladenen  Resource-Datei 
= Anzahl  der  Farbebenen  (1  — 4) 

= reserviert 
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global  [12] 
global  [13] 


global  [14] 


reserviert 

Bit-Vektor,  der  angibt,  welche  Laufwerke  auf  dem  GEM-Desktop  in- 
stalliert  wurden.  1st  das  Bit  gesetzt,  so  wurde  das  Laufwerk  installiert. 
Dabei  gelten  folgende  Bitbelegungen: 

Bit  15  = Laufwerk  A 
Bit  14  = Laufwerk  B 
Bit  13  = Laufwerk  C 
usw. 

Bit  0 = Laufwerk  P 

Bit-Vektor,  der  angibt,  ob  das  installierte  Laufwerk  ein  Diskettenlauf- 
werk  Oder  eine  Harddisk  ist.  Ein  gesetztes  Bit  bedeutet,  daB  es  sich 
um  eine  Harddisk  handelt. 


— Der  Parameter-Block 

Er  hat  nur  Bedeutung,  wenn  man  selbst  die  Parameter  an  das  AES  iibergeben  mochte. 
Im  Normalfall  werden  iiber  High-Level-Funktionsaufrufe  (C,  Pascal  usw.)  die  benotigten 
Parameter  aufbereitet  und  an  das  AES  iibergeben. 

Um  die  Parameter  selbst  an  das  AES  zu  iibergeben,  muB  der  sogenannte  Parameter-Block 
erstellt  werden.  Er  hat  folgenden  einfachen  Aufbau  (C-Schreibweise): 

# define  C_SIZE  5 
# define  G_SIZE  15 
# define  I_SIZE  16 
# define  0_SIZE  7 
# define  AI_SIZE  2 
# define  AO.SIZE  5 

typedef  struct  gemblkstr 

[ 

LONG  gb_pcontrol; 

LONG  gb_pglobal; 

LONG  gb_pintln; 

LONG  gb_p intout; 

LONG  gb_padrin; 

LONG  gb_padrout; 

] GEMBLK; 

EXTERN  WORD  gem  (); 

GLOBAL  GEMBLK  gb; 

GLOBAL  UWORD  control  [C_SIZE] ; 

GLOBAL  UWORD  global  [G_SIZE]; 

GLOBAL  UWORD  int.in  [I_SIZE]; 
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GLOBAL  DWORD  lnt_out  [0_SIZE]j 
GLOBAL  LONG  addr.in  [AI.SIZE]; 

GLOBAL  LONG  addr.out  [A0_SIZE] ; 

GLOBAL  LONG  ad_g; 

WORD  gein_if  (opcode) 

WORD  opcode; 

{ 

WORD  i; 

BYTE  »pctrl; 

control [0]  = opcode; 

pctrl  = &ctrl_cnts[( opcode  — 10)  * 3]> 
for(i=l;  i<=CTRL_CNT;  1++)  control[i]  = *pctrl++; 

gem  (ad_g); 

return  ( (W0RD)RET_C0DE) ; 

) 


struct  aes_parameters 

[ 

WORD  ^control; 

WORD  ^global; 

WORD  *int_in; 

WORD  *int_out; 

LONG  »addr_ln; 

LONG  »addr_out; 

); 

struct  aes_parameters  pblock  = 

(control,  global,  int_in,  lnt_out,  addr_ln,  addr_out) ; 

Die  Variable  pblock  enthalt  also  die  Adressen  der  6 AES-Parameter.  Nun  mufl  nur  noch 
die  Adresse  der  Variablen  pblock  sowie  eine  ID-Nummer  in  die  entsprechenden  Register 
geladen  werden.  AnschlieBend  erfolgt  ein  Software-Interrupt  oder  ein  Trap-Befehl. 


a)  INTEL-Modell  (IBM  PC’s  und  Kompatible) 

Die  Adresse  des  Parameter-Blockes,  welcher  sich  auf  dem  Stack  befindet,  muB  in  die  Re- 
gister AX:BX,  sowie  der  ID-Wert  200  (Hex  $C8)  in  das  Register  CX  iibertragen  werden. 
AnschlieBend  muB  der  Interrupt  $EF  ausgefuhrt  werden. 
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In  8086-Assembler  konnte  dies  wie  folgt  aussehen: 


push 

bp 

raov 

bp,sp 

mov 

cx,200 

mov 

dx,0 

mov 

bx,4[bp] 

mov 

ax,6[bp] 

mov 

es,ax 

int 

OEFh 

pop 

ret 

bp 

b)  68000-Modell  (ATARI  ST,  TT) 

Die  Adresse  des  Parameter-Blockes,  welcher  sich  auf  dem  Stack  befindet,  muB  in  das 
Register  DLL,  sowie  der  ID-Wert  200  (Hex  $C8)  in  das  Register  DO.W  ubertragen  wer- 
den.  AnschlieBend  muB  der  Interrupt  TRAP  #2  ausgefiihrt  werden. 

In  68(KX)- Assembler  konnte  dies  wie  folgt  aussehen: 

_gem:  move.l  4(A7),D1 

move.w  #200,00 
trap  # 2 
rts 

Fur  beide  Modelle  gilt  dann,  daB  das  AES  angesprungen  wird  und  die  Parameter  ausge- 
wertet  werden.  Das  AES  fullt  die  Ausgabeparameter  int_out  und  addr_out,  da  es  ja  die 
Adressen  der  beiden  Felder  kennt.  Von  dort  kann  dann  die  Applikation  die  Werte  wieder 
iibernehmen.  Benutzt  man  eine  hdhere  Programmiersprache,  ubernehmen  die  Bindings 
(AES-Libraries)  die  Ubertragung  der  Werte  aus  den  Ausgabearrays  in  die  Parameter  der 
Funktionsaufrufe. 


2.4.5  Allgemeine  AufrufFoIgen  im  AES 

An  dieser  Stelle  mochten  wir  uns  ansehen,  welche  AES-Funktionen  zu  welchem  Zeit- 
punkt  benutzt  werden  miissen,  um  eine  Standardapplikation  aufzubauen.  Eine  Standard- 
applikation  wie  der  GEM-Desktop,  GEMDRAW  oder  WORDPLUS  kann  man  sich  wie 
folgt  vorstellen: 

Das  Programm  wird  initialisiert,  besitzt  eine  Meniileiste  am  oberen  Bildschirmrand,  be- 
nutzt Piktogramme,  die  auf  dem  Desktop  abgelegt  sind,  zeigt  Dialogboxen,  wenn  be- 
stimmte  Meniipunkte  angewahlt  werden  und  es  koimen  Bildschirmfenster  kreiert,  geoff- 
net,  geschlossen  und  verschoben  werden.  Dabei  muB  das  Innere  des  Fensters  zu  bestimm- 
ten  Zeitpunkten  auf  den  neuesten  Stand  gebracht  werden. 
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a)  Initialisierung  der  Applikation 

Bevor  das  Hauptprogramm  gestartet  wird,  wird  vom  Initialisierungcode  des  Compilers 
der  Speicher  freigegeben,  der  nicht  von  der  Applikation  benotigt  wird.  Dieser  Initialisie- 
rungscode  (meist  Startupcode  genannt)  wird  beim  Linkvorgang  der  Applikation  vorange- 
stellt  und  iibernimmt  diese  Aufgabe.  Man  braucht  sich  selbst  nicht  darum  zu  kiimmern. 


Die  AES-Datenstrukturen  (Parameterblock  und  entsprechende  Felder)  mussen  deklariert 
und  initialisiert  werden.  Auch  dies  wird  von  den  sogenannten  Bindings  schon  erledigt, 
wenn  man  in  hdheren  Programmiersprachen  seine  Applikation  erstellt. 


Der  erste  Aufruf,  den  eine  Applikation  machen  muB,  ist  dann  appLinit.  Die  Funktion 
gibt  die  Applikations-ID  (ap_id)  zuriick,  die  im  Feld  global  (s.o.)  abgelegt  wird.  Daran 
kann  das  GEM-System  jedesmal  die  Applikation  erkennen,  wenn  weitere  AES-Aufrufe 
getatigt  werden. 


b)  Bildschirmaufldsung  bestimmen 

Alle  professionellen  GEM-Programme  laufen  mit  beliebigen  Bildschirmauflbsungen. 
Ihnen  ist  es  egal,  ob  der  Bildschirm  640x200  oder  1280x960  Pixel  breit  bzw.  hoch  ist. 
Alle  anderen  Programme,  die  dies  nicht  konnen,  sind  keine  korrekten  GEM-Programme 
und  ignorieren  die  Idee,  die  GEM  zu  verwirklichen  versucht:  Totale  Hardwareunabhan- 
gigkeit  aller  Software! 

Gliicklicherweise  existieren  heute  so  viele  Grafikkarten  und  Bildschirmgerate  mit  ver- 
schiedenen  Auflosungen  und  Farbebenen,  daB  niemand  mehr  daran  vorbeikommt,  saube- 
re  GEM-Applikationen  zu  schreiben. 

Urn  die  Bildschirmaufldsung  zu  bestimmen,  mussen  VDI-Aufrufe  getatigt  werden.  Da 
der  Bildschirm  bei  der  Initialisierung  des  GEM  schon  durch  das  VDI  physikalisch  gedff- 
net  wurde  (v_opnwk),  kann  der  Bildschirm  nur  noch  virtuell  gedffnet  werden 
(v^opnvwk).  Dazu  muB  das  VDI-Handle  des  physikalischen  Gerates  Bildschirm  be- 
kannt  sein.  Dies  erhalt  man  durch  die  AES-Funktion  graf_handle.  Damit  dffnet  man 
den  Bildschirm  virtuell  und  bekommt  im  work  out-Feld  samtliche  Informationen  iiber 
das  Gerat  Bildschirm. 


c)  Laden  der  Resource-Datei 

Jetzt  kann  entsprechend  der  Bildschirmaufldsung  die  Resource-Datei  geladen  werden.  Ei- 
nige  Programme  benutzen  verschiedene  Dateien  je  nach  Bildschirmaufldsung.  Dies  laBt 
sich  leider  nicht  immer  vermeiden,  da  z.B!  Piktogramme,  die  fiir  eine  hohe  Aufldsung 
erstellt  wurden,  in  einer  niederen  Aufldsung  verzerrt  erscheinen  (z.B.  doppelt  so  hoch) 
Oder  nicht  ganz  in  den  Rahmen  passen,  fiir  den  sie  vorgesehen  sind. 
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Beim  Laden  der  Resource-Datei  mit  rsrc_load  werden  vom  GEM  noch  einige  Umwand- 
lungen  vorgenommen.  Alle  Zeiger,  die  sich  in  einer  Resource-Datei  befmden,  sind  relativ 
zu  0 bzw.  relativ  zu  einem  Feld  (siehe  auch  Kapitel  5.3  itn  Buch  „Softwareentwicklung 
auf  dem  ATARI  ST“,  Hiithig  Verlag).  Sie  werden  entsprechend  der  Ladeadresse  vom 
Resource-Lader  angepafit. 

Die  X-  und  Y-Werte  sowie  die  Breite  und  Hohe  von  Objekten  in  einer  Resource-Datei 
sind  in  Zeichenkoordinaten  angegeben.  Dabei  geht  das  GEM-System  davon  aus,  dall  man 
einen  Standardbildschirm  von  80  Zeichen  zu  25  Zeilen  benutzt.  Ein  Objekt  mit  der  Breite 
4 und  der  Hdhe  2 ist  also  so  breit  wie  4 Zeichen  und  so  hoch  wie  2 Zeichen  des  Standard- 
zeichensatzes  (vst_font  mit  Parameter  1).  Beim  Laden  der  Resource-Datei  werden  also 
X,  Y,  Breite  und  Hohe  jedes  Objektes  mit  der  GroUe  des  Standardzeichensatzes  multipli- 
ziert.  Danach  stehen  die  Werte  in  Pixelkoordinaten  des  RC-Systems  im  Objektbaum. 
Dann  konnen  sie  von  der  Appliaktion  aus  weiter  benutzt  werden  (siehe  auch  Funktion 
rsrc_obfix) . 

d)  Holen  der  Resource- Adressen 

Nachdem  die  Resource-Datei  erfolgreich  geladen  wurde,  muB  man  sich  zu  jedem  Objekt- 
baum (Meniizeile,  Dialogbox,  Fehlermeldung  etc.)  die  Adresse  besorgen.  Diese  speichert 
man  in  einer  Variablen  vom  Typ  Zeiger  auf  OBJECT  ab.  Die  Adresse  eines  Objektbau- 
mes  kann  man  sich  mit  der  Funktion  rsrc_gaddr  besorgen.  Man  ruft  die  Funktion  also 
fiir  jeden  Baum  auf.  Die  Namen  (C-Konstanten),  die  bei  diesem  Aufruf  angegeben  wer- 
den, konnen  mit  dem  Resource-Construction-Set  vergeben  werden. 


e)  Anzeigen  der  Meniizeile 

Die  Meniizeile  ist  ein  Objektbaum,  deren  Adresse  man  sich  gerade  besorgt  hat.  Durch 
den  Aufruf  menu_bar,  bei  dem  man  die  Adresse  und  den  Wert  TRUE  iibergibt,  wird 
die  Meniizeile  vom  AES  automatisch  gezeichnet. 


f)  Piktogramme  auf  dem  Desktop  darstellen 

Der  Desktop  ist  der  Bereich  des  Bildschirms  unterhalb  der  Meniizeile.  Dieser  Bereich 
wird  auch  als  Desktop-Fenster  bezeichnet,  dessen  Kennung  mit  0 bei  Aufrufen  von  Funk- 
tionen  aus  der  Fenster-Bibliothek  angegeben  wird. 

Grundsiitzlich  gibt  es  2 Moglichkeiten,  Piktogramme  auf  dem  Desktop-Fenster  darzustel- 
len:  Man  zeichnet  die  Piktogramme  selbst  Oder  man  installiert  ein  neues  Desktop-Fenster. 

Bevor  man  eine  der  beiden  Moglichkeiten  wahlt,  miissen  jedoch  die  Piktogramme  umge- 
wandelt  werden.  In  der  Resource-Datei  liegen  sie  im  Standardformat  vor,  und  sie  miissen 
in  das  geratespezifische  Format  gewandelt  werden  (siehe  auch  VDI-Funktion 
vr_trnfm). 
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Das  Desktop-Fenster  hat  eine  bestimmte  GroBe  (BildschirmgroBe  abzQglich  Meniileiste). 
Diese  GroBe  sollte  jetzt  bestimmt  warden.  Dazu  bedient  man  sich  der  Funktion 
wind_get  mit  Fensterkennung  0 und  der  Konstanten  WF_WXYWH.  Man  erhalt  die 
Werte  X,  Y,  Breite  und  Hohe  des  Desktop-Fensters  auf  dem  gesamten  Bildschirm.  Bei 
einer  Auflosung  von  640x400  warden  z.B.  die  Werte 

X = 0 
y = 19 
width  = 640 
height  = 381 

zuriickgegeben,  je  nachdem,  wie  hoch  die  Meniileiste  ist,  was  wiederum  vom  verwende- 
ten  Zeichensatz  abhangt. 

Mochte  man  die  Piktogramme  selbst  zeichnen,  so  kann  dies  jetzt  mit  der  Funktion 
objc_draw  gemacht  warden.  Warden  diese  Piktogramme  irgendwann  aber  einmal  ver- 
deckt  (z.B.  durch  ein  Fenster  eines  Accessories)  und  kommen  wieder  zum  Vorschein, 
so  muB  man  sich  selbst  darum  kiimmern,  sie  neu  zu  zeichnen. 

Aus  diesem  Grund  raten  wir  zur  zweiten  Methode.  In  diesem  Falle  installieren  wir  das 
Desktop-Fenster  mit  der  Kennung  0 neu  und  iibergeben  einen  Objektbaum,  der  die  Pikto- 
gramme fiir  den  neuen  Desktop  enthalt.  Ist  der  neue  Desktop  erst  einmal  installiert  (siehe 
wind_set  mit  der  Konstanten  WF_NEWDESK),  dann  iibernimmt  das  AES  die  Update- 
Arbeit,  wenn  Objekte  z.B.  durch  Verschieben  eines  Fensters  wieder  zum  Vorschein 
kommen. 


g)  Warten  auf  Benutzerereignisse 

Nachdem  der  Bildschirm  (Meniizeile  und  Desktop)  der  Applikation  aufgebaut  ist,  sollte 
man  auf  Ereignisse  eines  Benutzers  warten.  Solche  Ereignisse  kdnnen  sein: 

— Driicken  einer  Taste 

— Driicken  eines  Mausknopfes 

— Mausbewegungen 

— Nachrichten  von  AES-Prozessen  (z.B.  vom  Fenstermanager) 

— Ablauf  einer  bestimmten  Zeitdauer 

Man  kann  auf  Jedes  Einzelereignis  warten.  D.h.  wartet  man  auf  einen  Mausknopf,  so 
kann  man  nicht  gleichzeitig  auf  das  Driicken  einer  Taste  warten.  Zu  diesem  Zweck  gibt 
es  ein  kombiniertes  „Warten“  (event_multi),  das  auf  beliebig  kombinierbare  Ereignisse 
warten  kann. 

Tritt  das  Ereignis  auf,  so  bekommt  man  eine  Meldung  des  GEM-Sy stems  in  den  Nach- 
richtenpuffer  gesetzt,  den  man  auslesen  muB.  Nachrichten  konnen  sein:  Accessory  wurde 
geoffnet,  Fenster  wurde  verschoben  oder  geschlossen  uvm.  Man  unternimmt  dann  die 
entsprechende  Aktion  (siehe  auch  EVENT. C)  und  wartet  auf  die  nachste  Nachricht. 
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h)  Meniiauswahl 

Die  Meniizeile  wird  voni  Bildschirmmanager  automatisch  verwaltet,  d.h.  das  Herunter- 

kJappen  und  Invertieren  von  Meniieintragen  muB  nicht  selbst  vorgenommen  werden.  Am 

Beispiel  des  SCRAP  Programmes,  das  sich  auf  der  Diskette  befindet,  wollen  wir  uns  in 

etwa  den  Ablauf  verdeutlichen: 

— Die  Applikation  wartet  auf  ein  Ereignis,  meist  ein  Multi-Event. 

— Der  Benutzer  bewegt  die  Maus  in  das  SCRAP-Menii,  wobei  der  Bildschirmmanager 
das  Menii  herunterklappt,  den  Hintergrund  vorher  rettet  und  die  Menueintrage  ent 
sprechend  den  Mausbewegungen  invertiert. 

— Der  Benutzer  klickt  in  den  Meniipunkt  „Uber  SCRAP..." 

— Der  Bildschirmmanager  schreibt  die  Nachricht  MN_SELECTED  (Menii  ausge- 
wahlt)  in  den  Nachrichtenpuffer  der  Applikation  und  gibt  die  Nummer  im  Objekt- 
baum  „Menuleiste“  mit  zuriick.  Diese  Nummer  kann  iiber  Konstanten  abgefragt  wer- 
den. Die  Konstanten  werden  im  Resource-Construction-Set  vergeben. 

— Das  Warten  der  Applikation  auf  ein  Ereignis  wird  beendet. 

— Die  Applikation  interpretiert  das  Ereignis  und  den  Nachrichtenpuffer  und  bringt  eine 
Dialogbox  auf  den  Schirm. 

— Der  Meniititel  „SCRAP“  bleibt  noch  so  lange  invers,  bis  der  Benutzer  in  der  Dialog- 
box  „OK“  angewahlt  hat.  Jetzt  setzt  die  Applikation  den  Meniititel  durch  die  Funk- 
tion  menu_tnormal  wieder  auf  Normalschrift. 


i)  Dialogbox  anzeigen  und  abhandeln 

Um  die  oben  beschriebene  Dialogbox  anzuzeigen,  werden  folgende  Schritte  unter- 

nommen: 

— Die  Adresse  des  Meniibaumes  ist  bekannt  (init_resource  in  RESOURCE. C). 

— Durch  die  Funktion  form_center  wird  erreicht,  daB  die  Dialogbox  in  der  Mitte  des 
Bildschirms  erscheinen  wird. 

— Die  Funktion  form^dial  mit  der  Konstanten  FMD_START  bewirkt,  daB  der  Be- 
reich,  den  die  Dialogbox  bedeckt,  als  belegt  gekennzeichnet  wird.  Der  Bildschirmma- 
nager wird  nach  Beenden  des  Dialoges  diesen  Bereich  alien  Applikationen  anbieten, 
damit  sie  das  Innere  eines  Fensters  restaurieren  konnen.  Die  Randteile  von  Fenstern 
sowie  der  Desktop  selbst  wird  automatisch  restauriert. 

— Jetzt  kann  mit  der  Funktion  objc_draw  die  gesamte  Dialogbox  gezeichnet  werden. 

— Durch  Aufruf  der  Funktion  form_do  wird  der  gesamte  Dialog  mit  der  Dialogbox 
vom  AES  abgehandelt. 

— Hat  der  Benutzer  auf  „OK“  geklickt,  so  wird  der  Knopf  invers  dargestellt  und  der 
Dialog  ist  beendet.  Jetzt  kann  die  Applikation  nachschauen,  welche  Werte  sich  im 
Objektbaum  geandert  haben  und  entsprechend  reagieren.  Der  Status  (ob_state)  des 
„OK“-Knopfes  hat  jetzt  den  Wert  „SELECTED“,  so  daB  die  Applikation  erkennen 
kann,  das  dieses  Objekt  aus  dem  Objektbaum  gewahlt  wurde.  Mit  der  Funktion 
undo_state  kann  dieser  Status  wieder  geandert  werden,  sonst  kame  der  „OK“- 
Knopf  beim  nachsten  Aufruf  schon  invertiert  hoch. 
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— Jetzt  kann  die  AES-Funktion  form_dial  mil  der  Konstanten  FMD_FINISH  aufge- 
rufen  werden.  Der  Bildschirmmanager  sendet  jetzt  an  alle  Applikationen  die  Mel- 
dung,  dall  der  Bildschirmbereich  wieder  frei  wurde,  damit  sie  ihren  Teil  des  Bild- 
schirms  restaurieren  konnen. 


j)  Meniiauswahl  iiber  Tastatur 

Durch  die  Angabe  von  MU  KEYED  im  Multi-Event  wartet  die  Applikation  zusatzlich 
auf  Tastendriicke.  Wurde  eine  Taste  gedriickt,  sollte  man  den  entsprechenden  Menutitel 
invertieren  (menu_tnormal),  damit  der  Benutzer  erkennt,  da6  eine  Meniiauswahl  statt- 
gefunden  hat.  Nach  Beendigung  der  Aktion  muB  der  Menutitel  wieder  auf  Normalschrift 
zuriickgesetzt  werden. 


k)  Selektieren  eines  Piktogrammes 

Wenn  der  Benutzer  ein  Piktogramm  einmal  mit  der  Maus  angeklickt  hat,  muB  folgendes 

passieren: 

— Beim  Warten  mittels  dem  event_multi-Befehl  wurde  angegeben,  daB  ein  Mausklick 
erwartet  wird  (MU_BUTTON).  Das  Warten  auf  das  Ereignis  wird  beendet,  wobei 
X-  und  y-Koordinaten  der  Maus  zuriickgegeben  werden. 

— Mit  dem  AES-Befehl  obJc_find  und  der  Angabe  der  Mauskoordinaten  sowie  des 
Objektbaumes  (z.B.  der  neue  Desktop)  bestimmt  das  AES  die  Objektnummer,  also 
das  gewahlte  Piktogramm.  Der  Wert  ob_state  des  gewahlten  Objekts  muB  jetzt  von 
NORMAL  auf  SELECTED  gestellt  werden.  Dies  besorgt  die  AES-Funktion 
objc„change. 

— Wurde  das  Piktogramm  gewahlt,  so  kann  es  vorkommen,  daB  dadurch  ein  Meniiein- 
trag  wahlbar  ist,  der  vorher  in  schwacher  Schrift  erschien.  Dieser  Meniieintrag  muB 
mittels  der  AES-Funktion  menu._ienable  in  Normalschrift  erscheinen. 


1)  Erzeugen  eines  Fensters 

Das  AES  iibernimmt  ein  Teil  der  Fensterverwaltung.  Alle  Elemente  eines  Fensters,  die 
nicht  innerhalb  des  Fenster  liegen,  werden  vom  AES  standig  auf  den  neuesten  Stand  ge- 
bracht  (z.B.  wenn  ein  Fenster  nach  oben  gebracht  wird).  Die  Applikation  ist  fiir  das  Inne- 
re  des  Fensters  verantwortlich.  Dies  ist  verstiindlich,  da  das  AES  nicht  wissen  kann,  was 
die  Applikation  dort  darstellen  mochte. 

Um  ein  Fenster  erscheinen  zu  lassen,  muB  es  kreiert  und  geoffnet  werden.  Beim  Kreieren 
wird  angegeben,  welche  Randkomponenten  das  Fenster  besitzen  soli  (Schieber,  SchlieB- 
box,  Infozeile  usw.)  und  welche  MaximaigroBe  es  haben  darf. 

Durch  den  Aufruf  wind_create  wird  das  Fenster  erzeugt,  wobei  eine  Fensterkennung 
(Wert  zwischen  1 und  n)  zuriickgegeben  wird.  Diese  Kennung  (window  handle)  wird  bei 
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jedem  weiteren  Aufruf  aus  der  Fensterbibliothek  benotigt.  Mil  Kennung  0 wird  der  AES 
Desktop  bezeichnet,  eine  negative  Kennung  zeigt  an,  daB  keine  Fenster  mehr  zur  Verfii- 
gung  stehen. 


m)  Offnen  eines  Fensters 

Das  Fenster  erscheint  beim  Aufruf  von  wind_open,  wobei  die  Fensterkennung  und  die 
Anfangsposition  iibergeben  wird.  Das  AES  zeichnet  jetzt  die  Randkomponenten  des  Een- 
sters  und  sendet  der  Applikation  die  Nachricht  WM_REDRAW,  was  bedeutet,  daB  sie 
das  Fensterinnere  neu  zeichnen  muB. 


n)  SchiebergroBen 

Das  Innere  eines  Fensters  kann  ganz  oder  nur  teilweise  angezeigt  werden.  Stellt  man  sich 
einen  Texteditor  vor,  so  wird  meist  nur  ein  Teil  des  Dokumentes  angezeigt,  da  der  gesam- 
te  Text  nicht  in  das  Fenster  paBt.  In  diesem  Fall  miissen  die  horizontalen  und  vertikalen 
Schieber  (Slider)  neu  gezeichnet  werden,  was  durch  den  AES-Befehl  wind_set  bewerk- 
stelligt  wird. 


o)  Verandern  der  FenstergroBe 

Zieht  der  Benutzer  an  der  rechten  unteren  Ecke  eines  Fensters  dieses  auf  eine  neue  GroBe, 
so  passiert  folgendes;  Das  AES  sendet  der  Applikation  die  Meldung  WM_SIZED  mit 
der  neuen  gewunschten  GroBe.  Die  Applikation  benutzt  diese  GroBe,  um  festzustellen, 
ob  sie  erlaubt  ist.  1st  die  GroBe  korrekt,  so  wird  durch  den  wind_set-Befehl  die  GroBe 
an  das  AES  als  korrekt  zuriickgegeben.  Ansonsten  wird  die  Applikation  die  neue  GroBe 
ignorieren  oder  sie  an  die  nachste  erlaubte  GroBe  anpassen. 

Ist  das  neue  Fenster  groBer  als  das  alte,  so  sendet  das  AES  wieder  die  Meldung 
WM_REDRAW,  da  die  jetzt  freien  Teile  von  der  Applikation  neu  gezeichnet  werden 
mussen. 


p)  Rechtecklisten 

Die  Applikation  muB  nur  die  Teile  des  Fensterinneren  zeichnen,  die  im  Augenblick  sicht- 
bar  sind.  Um  die  sichtbaren  Teile  eines  Fensters  zu  bestimmen,  legt  das  AES  sogenannte 
Rechtecklisten  an  und  halt  diese  auf  dem  neuesten  Stand.  Eine  Rechteckliste  besteht  aus 
so  vielen  nicht  iiberlagerten  Rechtecken,  wie  notig  sind,  um  das  Fensterinnere  zu  be- 
schreiben.  Ist  das  Fensterinnere  ganz  zu  sehen,  so  besteht  die  Rechteckliste  aus  einem 
Element,  namlich  dem  Fensterinneren.  Ist  es  durch  ein  anderes  Fenster  verdeckt,  so  be 
steht  die  Liste  mindestens  aus  2 Elementen. 

Um  das  Fensterinnere  zu  restaurieren,  holt  man  sich  in  einer  Schleife  diese  Rechtecke 
durch  wind_get-Aufrufe  und  den  Konstanten  WF_FIRSTXYWH  (erstes  Rechteck)  und 
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WF^NEXTXYWH  fur  alle  weiteren  Rechtecke.  Dann  setzt  man  das  Clipping  (vs„clip) 
auf  dieses  Rechteck  und  zeichnet  das  Fensterinnere  neu.  Dies  wird  so  lange  durchgefiihrt, 
bis  kein  Rechteck  mehr  zuriickgeliefert  wird  (Breite  und  Hohe  = 0). 


Vor  dem  Restaurieren  des  Fensterinhaltes,  also  dem  Zeichnen  auf  den  Bildschirm,  mu6 
dem  AES  unbedingt  mitgeteilt  werden,  daB  dieser  Vorgang  jetzt  ansteht.  Durch  den  Auf- 
ruf  wind_update  mit  dem  Wert  BEG_UPDATE  wird  nur  noch  unserer  Applikation  er- 
laubt,  den  Bildschirm  zu  andern.  Der  Bildschirmmanager  sowie  die  Desk-Accessories 
sind  gesperrt,  damit  das  Zeichnen  nicht  unterbrochen  wird. 


q)  Fenster  aktivieren 

Wurde  auf  ein  inaktives  Fenster  geklickt,  so  sendet  der  Bildschirmmanager  die  Meldung 
WM_TOPPED  mit  der  Fensterkennung,  Die  Applikation  entscheidet  nun,  ob  das  Fen- 
ster nach  oben  gebracht  werden  darf.  1st  dies  der  Fall,  so  geniigt  ein  wind  set-Aufruf 
mit  der  Fensterkennung  und  dem  Wert  WF_TOP.  Das  AES  bringt  das  Fenster  nach 
oben  und  sendet  die  Nachricht  WM_REDRAW,  die  von  der  Applikation  wie  iiblich  ab- 
gehandelt  werden  muB. 


r)  SchlieBen  und  Loschen  von  Fenstern 

Hat  der  Benutzer  auf  die  SchlieBbox  eines  Fensters  geklickt,  so  sendet  das  AES  die  Mel- 
dung WM  CLOSED.  Darf  das  Fenster  geschlossen  werden,  so  muB  die  Applikation  die 
Funktion  wind_close  aufrufen.  Das  Fenster  wird  dann  vom  Bildschirm  geloscht.  Das 
Fenster  kann  jederzeit  wieder  gedffnet  werden,  da  die  Fensterkennung  noch  nicht  freige- 
geben  wurde.  Dies  wird  mit  dem  Aufruf  wind_delete  gemacht.  Jetzt  ist  die  Kennung 
wieder  frei  (z.B.  fur  Fenster  von  Accessories). 


Zusammenfassung:  Das  letzte  Kapitel  hat  gezeigt,  wie  die  Aufruffolgen  aussehen  konnen, 
wenn  eine  GEM-Applikation  lauft.  Diese  Folgen  sind  mehr  oder  weniger  bei  alien  Appli- 
kationen  gleich.  Es  sieht  auch  so  aus,  als  ob  sehr  viel  Aufwand  getrieben  werden  muB, 
um  ein  System  mit  Bildschirmfenstern  zu  entwickeln.  Dies  ist  in  der  Tat  so.  Ziel  dieses 
Buches  ist  es  aber,  dem  Entwickler  so  viel  wie  moglich  Arbeit  abzunehmen,  damit  er 
sich  auf  das  Wesentliche  konzentrieren  kann.  So  ist  z.B.  das  Modul  WINDOWS. C des 
SCRAP-Programmes  eine  vollstandige  Fensterverwaltung,  an  der  nichts  mehr  geandert 
werden  muB.  Der  Entwickler  muB  praktisch  nur  noch  die  Funktion  zur  Verfiigung  stellen, 
die  das  Innere  des  Fensters  zeichnet. 


Das  Gleiche  gilt  fur  die  Behandlung  von  Resourcen.  So  wird  die  Anpassung  von  Pikto- 
grammen  an  verschiedene  Grafikkarten  iiber  die  VDI-Funktion  v_trnfm  vollstandig  in 
dem  Modul  RESOURCE. C ubernommen.  Auch  andere  Anpassungen  wie  benutzerdefi- 
nierte  Objekte  werden  automatisch  verwaltet. 
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Das  Programm  SHOWGEM,  welches  GEM-Metafiles  ausgibt,  kann  als  Mini- 
Beispielapplikation  ohne  Meniileiste  zum  Verstandnis  der  Behandlung  von  Alert-  und 
Dialogboxen  dienen.  Wer  GEM  aber  komplett  verstehen  will,  sollte  sich  das  Programm 
SCRAP  als  Komplettbeispiel  ansehen.  Es  beinhaltet  alles,  was  ein  professionelles  GEM- 
System  benotigt.  Auf  dieses  Tool  aufbauend,  kdnnen  perfekte  GEM-Applikationen  auf 
alien  Rechnern  entwickelt  warden. 


2.4.6  Allgemeine  Vorgehensweise  beiiti  Aufbau  eines  GEM-Programms 

Um  ein  GEM-Programm  zu  entwickeln,  sollte  man  sich  zuniichst  iiberlegen,  welche 
Funktionen  damit  ausgefuhrt  warden  sollen.  Anhand  der  Funktionalitat  kann  man  als  er- 
stes  eine  Meniileiste  mit  den  entsprechenden  Drop-Down-Menus  erstellen.  Es  spiegelt  zu 
80  Prozent  die  Moglichkeiten  einer  Applikation  wieder. 

Der  nachste  Schritt  ist  die  Uberlegung,  wie  die  einzelnen  Dialoge  auszusehen  haben,  die 
per  Menii-  oder  Piktogrammwahl  erscheinen  sollen.  Im  Programm  SHOWGEM. C z.B. 
ist  eine  Dialogbox  fur  alle  Einstellungen  und  den  Start  der  Ausgabe  vorgesehen. 

Das  Erzeugen  und  Erstellen  von  Meniileisten  und  Dialogboxen  geschieht  im  GEM  inter- 
aktiv.  Dazu  existiert  ein  wichtiges  Programm  namens  RCS  oder  auch  Resource- 
Construction-Set.  Verschiedene  Firmen  liefern  mit  ihren  Compilern  eventuell  andere 
Versionen  aus,  aber  es  handelt  sich  im  Endeffekt  immer  um  das  gleiche  Programm.  Eine 
ausfuhrliche  Beschreibung  der  Bedienung  von  solch  einem  System  wiirde  hier  zu  weit 
fiihren.  Es  gibt  sie  aber  in  dem  Buch  „Softwareentwicklung  auf  dem  ATARI  ST“,  das 
wir  beim  gleichen  Verlag  veroffentlicht  haben. 

Wahrend  der  Programmentwicklung  wird  man  auch  merken,  daB  man  diese  oder  jene 
Fehlermeldung  benotigt.  Auch  Fehlermeldungen  werden  mit  dem  RCS  erstellt. 

Das  Ergebnis  einer  RCS-Sitzung  ist  eine  Datei,  die  die  kompletten  Resourcen  einer  GEM- 
Applikation  enthalt.  Die  Datei  hat  immer  das  Suffix  RSC  (Resource)  und  enthalt  Meniilei- 
sten,  Dialogboxen,  Fehlermeldungen,  Piktogramme,  Hilfemeldungen  usw.  Der  Vorteil 
von  solchen  Resource-Dateien  liegt  auf  der  Hand;  fiir  die  Ubersetzung  in  andere  Sprachen 
muB  das  Programm  nicht  neu  geschrieben  oder  ubersetzt  werden,  sondern  nur  die 
Resource- Datei  mit  den  fremdsprachigen  Texten  behandelt  werden. 

Zu  jeder  Dialogbox  oder  Meniileiste  gehort  ein  Objektbaum.  Die  Wurzel  des  Baumw  ist 
die  Box,  alle  Objekte  in  der  Dialogbox  sind  Kinder  dieser  Box  (siehe  auch  Object- 
Library).  Jedem  Objekt  (Zeichenkette,  Knopf,  Piktogramm,  Menutitel,  Meniieintrag, 
editierbare  Textfelder)  kann  im  RCS  ein  Objektname  zugewiesen  werden.  Diese  Namen 
sind  Konstanten  z.B.  fiir  ein  C-Programm.  Die  Konstante  ist  der  Index  des  Objekts  im 
entsprechenden  Objektbaum.  Um  ein  Objekt  beim  Programmieren  anzusprechen,  beno- 
tigt man  die  Wurzel  des  Objekts  und  den  Index  (die  Objektnummer  im  Baum).  Diese 
Nummern  werden  vom  RCS  automatisch  vergeben,  und  man  braucht  sich  nicht  um  sie 
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zu  kiimmern.  Man  gibt  also  nur  den  Objekten  einen  Namen,  mil  denen  man  spater  arbei- 
ten  mochte.  Die  Uberschrift  einer  Dialogbox  z.B.  muB  keinen  Namen  im  RCS  bekom- 
men,  da  sie  sich  ja  nie  andert. 

Die  Konstanten  werden  in  eine  Datei  mit  Suffix  „.H“  geschrieben,  die  man  in  sein  C- 
^ Programm  inkludieren  kann.  Man  hat  dann  Zugriff  auf  die  Objekte  per  Namen.  Uber  den 
AES-Befehl  rsrc_load  kdnnen  die  Resource-Datei  geladen  und  die  Objektbaume  an  Va- 
riablen  zugewiesen  werden.  Das  Programm  SHOWGEM  zeigt  die  Benutzung  einer 
Resource-Datei  und  der  Objektbaume  in  der  Datei.  Da  es  sich  nur  um  eine  kleine  Applika- 
tion  handelt,  ist  der  Vorgang  des  Benutzens  noch  recht  iibersichtlich  und  fur  Anfanger 
geeignet.  Eine  genaue  Beschreibung  befindet  sich  in  Kapitel  4. 

Wenn  die  Resourcen  geladen  sind,  zeigt  man  die  Meniileiste  an  und  wartet  mit  dem  Befehl 
evnt_multi  auf  ein  Ereignis.  Wann  ein  Ereignis  auftritt,  wurde  weiter  oben  beschrieben. 
Je  nach  Ereignis  wird  man  ein  Fenster  offnen  oder  z.B.  eine  Dialgbox  anzeigen  und  ab- 
handeln.  Das  Programm  SCRAP  zeigt  alle  Moglichkeiten  von  Ereignissen  und  deren  Be- 
handlung  an. 


2.4.7  Funktionen  der  AES-Gruppen 

Die  AES-Funktionen  wurden  schon  in  sehr  vielen  Biichern  beschrieben.  Aber  der  erkla- 
rende  Text  Jeder  einzelnen  Funktion  war  meist  nur  1 oder  2 Zeilen  lang.  Oft  wurden  auch 
die  falschen  Erklarungen  gegeben.  Es  sollen  an  dieser  Stelle  alle  Funktionen,  die  eine 
ausfiihrliche  Erklarung  benotigen,  genau  besprochen  werden.  Funktionen,  die  keine  gro- 
Be  Bedeutung  haben,  werden  nur  der  Vollstandigheit  halber  aufgelistet. 

Zum  Nachschlagen  der  Parameter  jeder  einzelnen  Funktion  kann  ein  x-beliebiges  GEM- 
Buch  benutzt  werden.  Wir  empfehlen  das  Buch  aus  gleichem  Verlag  („Softwareentwick- 
lung  auf  dem  ATARI  ST“),  das  alle  GEM-Funktionen  bis  GEM  2.X  beschreibt.  Parame- 
ter werden  in  diesem  Kapitel  nur  dort  erlautert,  wo  es  fur  das  Verstandnis  wichtig  er- 
scheint.  AuBerdem  werden  alle  neuen  GEM/3-Funktionen  mit  Parametern  genau  erlau- 
tert, da  diese  in  keinem  einzigen  Buch  fur  den  ATARI  ST  erwahnt  werden,  aber  fur  den 
einen  oder  anderen  interessant  sind,  der  Programme  fur  ATARI  und  MS-DOS  erstellen 
mochte. 

Zu  jeder  Bibliothek  (Library)  werden  in  einer  Tabelle  kurz  alle  Funktionen  mit  ihrem 
Zweck  aufgelistet.  Vor  dem  C-Funktionsnamen  werden  die  Funktionsnummern  angege- 
ben.  Wir  verwenden  wieder  die  englischen  Namen,  um  das  Benutzen  der  Originaldoku- 
mentation  zu  erleichtern. 


1.  APPLICATION-LIBRARY 

Sie  wird  benotigt,  um  alle  AES-Aufrufe  zu  initialisieren.  AuBerdem  kann  man  Nachrich- 
ten  zwischen  Applikationen  austauschen.  Vor  der  Beschreibung  der  Funktion  soil  noch 
der  Begriff  „Nachricht“  erlautert  werden. 
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Eine  Nachricht  befindet  sich  in  einem  Feld  mil  Grundtyp  WORD  (also  16  Bit).  Das  Feld 
ist  8 Elemente  groB.  In  C-Schreibweise  also: 

GLOBAL  WORD  msgbuff  [8]; 

Dieses  Feld  wird  von  der  Applikation  gefiillt,  falls  es  Nachrichten  senden  mochte.  Beim 
Lesen  von  Nachrichten  wird  es  vom  AES  gefiillt.  Die  einzelnen  Felder  haben  folgende 
Bedeutung: 


msgbuf  [0]  = Typ  der  Nachricht 

msgbuf  [1]  = Applikationskennung  (ap_id)  des  Absenders 
msgbuf  [2]  = — 1 

msgbuf  [3]  = Lange  der  Nachricht  in  Bytes 

msgbuf  [4]  — msgbuf  [5]  = Adresse  des  Nachrichtenpuffers 

msgbuf  [6]  = frei  verwendbar 

msgbuf  [7]  = frei  verwendbar 


10 

— appLinit 

Applikation  initialisieren 

11 

— appl_read 

Nachricht  lesen 

12 

— appLwrite 

Nachricht  schreiben 

13 

— appLfind 

andere  Applikationen  finden 

14 

— appl_tp!ay 

AES-Funktionen  aufnehmen 

15 

- appl_trecord 

AES-Funktionen  abspielen 

16 

— appl_bvset 

Disk-Info  setzen 

17 

- appl_yield 

ProzeB  umschalten 

19 

— appl_exit 

Applikation  beenden 

- APPL__IN1T 

- APPL_EXIT 

Der  appLinit-Aufruf  muB  vor  alien  anderen  AES-Aufrufen  gemacht  werden.  Er  initiali- 
siert  die  internen  Strukturen  des  AES.  AuBerdem  wird  das  Feld  global  (s.o.)  mit  Informa- 
tionen  gefiillt. 

Beim  Aufruf  wird  ein  interner  Zahler  auf  0 gestellt.  Dieser  Zahler  wird  bei  jedem  weite- 
ren  AES-Aufruf  inkrementiert.  Erreicht  der  Zahlerstand  10,  so  erfolgt  das  erste  Umschal- 
ten  auf  einen  anderen  ProzeB.  Dies  hat  zur  Konsequenz,  daB  die  Applikation  innerhalb 
der  ersten  10  AES-Aufrufe  die  dringlichsten  Sachen  erledigen  muB.  Dazu  gehort  vor  alien 
Dingen  das  dynamische  Reservieren  von  Speicher  und  das  Laden  von  Resource-Dateien . 
Wird  dies  nicht  gemacht,  so  konnen  andere  Prozesse  dazwischenkommen.  Fordern  diese 
vom  Betriebs system  ebenfalls  Speicher  an,  so  sind  alle  Speicherblocke  zerrissen.  Diesen 
Umstand  kann  man  besonders  bei  Accessories  beobachten. 

Durch  den  Aufruf  appLexit  wird  dem  AES  mitgeteilt,  daB  unsere  Applikation  jetzt 
beendet  ist,  Weitere  AES-Aufrufe  sind  dann  nicht  mehr  moglich. 
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- APPL_READ 

Hiermit  wird  eine  Nachricht  gelesen.  Man  iibergibt  die  Kennung  der  Applikation,  fur  die 
die  Nachricht  gelesen  werden  soil,  also  unserer  eigenen  Applikation. 


- APPL_ WRITE 

Dies  ist  das  Gegenstiick  zu  appLread.  Man  kann  eine  Nachricht  an  eine  andere  Appli- 
kation senden  (z.B.  an  ein  Desk-Accessory  wie  den  Druckerspooler).  Dazu  muB  man  die 
Kennung  (ap_id)  der  Empfangerseite  herausfmden.  Man  erhalt  sie  mit  einem 
appl_find-Aufruf.  Es  ist  also  moglich,  mit  anderen  Programmen  im  System  elegant  zu 
kommunizieren.  Eigene  Message-Typen  sollten  mit  Nummem  von  1000  bis  32000  nume- 
riert  sein. 


- APPL_F1ND 

Um  die  Kennung  (ap_id)  von  anderen  Applikationen,  die  gerade  laufen,  zu  erfahren, 
muB  die  Funktion  appl_fmd  aufgerufen  werden.  Man  iibergibt  den  Dateinamen  (ohne 
Suffix)  und  fiillt  bis  zu  8 Zeichen  auf,  falls  dieser  kiirzer  ist. 

Beispiel: 

msgbuf  [0]  = gl_apid; 


scrap_id  = appLfind  (’’SCRAP  ”);  /*  3 Leerzeichen  nach  SCRAP*/ 

if  (scrap_id  > 0)  appl_write  (scrap_id,  16,  msgbuf); 

Das  Beispiel  sucht  die  Applikation  SCRAP.  Dies  konnte  ein  Accessory  mit  Namen 
SCRAP.  ACC  sein  (siehe  auch  Kap.  6).  Falls  die  Applikation  gefunden  wurde,  wird  eine 
Nachricht  von  16  Bytes  gesendet.  Der  Puffer  msgbuf  muB  vorher  gefUllt  worden  sein. 
Das  nullte  Element  enthalt  unsere  eigene  Applikationskennung. 


- APPL_TPLAY 

- APPL_TRECORD 

Mit  diesen  beiden  Funktionen  konnen  AES-Ereignisse  aufgezeichnet  und  wiedergegeben 
werden.  Man  iibergibt  einen  Puffer  und  die  Anzahl  der  Ereignisse,  die  aufgezeichnet  wer- 
den sollen. 

Ein  Ereignis  besteht  aus  6 Bytes,  einem  WORD  und  einem  LONG-Wert.  Dies  gilt  aber 
nur  im  INTEL-Modell.  Im  Motorola  MC68000-Modell  (z.B.  ATARI  ST)  besteht  ein  Er- 
eignis aus  2 LONG-Werten!  Dies  wird  in  alien  uns  bekannten  Biichern  fur  GEM  auf  dem 
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ATARI  ST  falsch  beschrieben.  Da  diese  Funktion  relativ  unwichtig  ist,  werden  wir  sie 
auch  nicht  naher  beschreiben. 


- APPL_BVSET  (ab  GEM  2.x) 

Hiermit  kdnnen  Informationen  iiber  die  Disketten-  und  Festplattenlaufwerke  gesetzt  wer- 
den. Diese  Informationen  werden  im  global-Feld  abgelegt  (s.o).  Der  GEM-Desktop  z.B. 
benutzt  diesen  Aufruf,  wenn  Diskettenlaufwerke  angemeldet  werden. 

Soil  GEM  z.B.  Disk-Laufwerk  A:  und  die  Plattenlaufwerke  C:  und  D:  erkennen,  so  muB 
der  Aufruf  wie  folgt  aussehen: 

WORD  bvdlsk,  bvhard; 

bvdlsk  = 0x8000;  /*  10000000  00000000  Bit  15  gesetzt  */ 
bvhard  = 0x3000  /*  00110000  00000000  Bit  13  und  12  gesetzt  */ 
appl_bvset  (bvdisk,  bvhard); 


- APPL_ YIELD 

Hiermit  wird  der  Dispatcher  veranlaBt,  den  ProzeB  zu  wechseln.  Sind  z.B.  2 Desk- 
Accessories  und  unsere  Haupt-Applikation  aktiv,  und  rechnet  unsere  Applikation  in  einer 
Schleife,  ohne  einen  einzigen  AES-Befehl  zu  tatigen,  so  kommen  die  beiden  Accessories 
nicht  mehr  zum  Zuge.  Der  Druckerspooler  z.B.  kbnnte  keine  Zeichen  mehr  an  den 
Drucker  senden. 

Deshalb  sollte  bei  intensivem  Rechnen  zwischendurch  ein  app_yield-Aufruf  getatigt 
werden.  Der  Dispatcher  laBt  dann  in  unserem  Beispiel  die  Accessories  an  die  Reihe,  um 
unsere  Applikation  danach  fortzufiihren.  Der  Aufruf  existiert  bei  GEM- Version  1 .X  noch 
nicht,  kann  aber  mit  Hilfe  der  Datei  PORTAB.H  trotzdem  von  alien  benutzt  werden.  Dort 
wird  der  Aufruf  durch  einen  evnt_timer  simuliert. 


2.  EVENT-LIBRARY 


20  - 

evnt_keybd 

Tastaturereignis  abwarten 

21  - 

evnt_button 

Mausknopfereignis  abwarten 

22  - 

evnt_mouse 

Mausereignis  abwarten 

23  - 

evnt_mesag 

Nachrichtenereignis  abwarten 

24  - 

evnt_timer 

Zeitereignis  abwarten 

25  - 

evnt  multi 

Mehrfachereignis  abwarten 

26  - 

evnt_dclick 

Doppelklick  lesen/schreiben 
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Wer  schon  einmal  dialogorientierte  Anwendungssoftware  geschrieben  hat,  der  wei6,  dal3 
man  in  seiner  Applikation  auf  Eingaben  des  Anwenders  reagieren  muB,  Eingaben  in  ei- 
nem  professionellen  Anwendungsprogramm  konnen  von  verschiedensten  Quellen  kom- 
men.  Der  Benutzer  kann  die  Tastatur  betatigen,  mit  der  Mans  Mentis  anwahlen  und  den 
Mausknopf  driicken.  AuBerdem  kann  er  mit  der  Maus  bestimmte  Bereiche  (meist  Bild- 
schirmfenster)  anfahren.  Die  Applikation  kann  aber  auch  ohne  Eingaben  irgend  etwas 
tun.  So  stelle  man  sich  einen  Druckerspooler  vor,  der  einmal  angestoBen  wird  und  dann 
jede  1/100  Sekunde  ein  Zeichen  an  den  Drucker  sendet.  In  solch  einem  Fall  sprechen 
wir  von  einem  Zeitereignis. 


Tatigt  der  Benutzer  irgendeine  der  obigen  Eingaben,  so  muB  die  Applikation  darauf  rea- 
gieren. Das  Resultat  einer  Benutzeraktion  wird  auch  „Ereignis“  genannt.  Driickt  der  Be- 
nutzer eine  Taste,  so  spricht  man  entsprechend  von  einem  „Tastaturereignis“.  In  alteren 
Systemen  wird  das  Warten  auf  verschiedene  Ereignisse  durch  eine  Schleife  (Polling)  rea- 
lisiert,  in  der  stiindig  die  Tastatur,  die  Maus,  Mauskndpfe  und  verstrichene  Zeiten  abge- 
fragt  werden.  Das  System  war  also  stiindig  damit  beschaftigt,  Abfragen  vorzunehmen. 
Dies  kostet  natiirlich  eine  Menge  Zeit. 


Um  diese  Ineffizienz  zu  vermeiden,  bietet  das  GEM-System  die  Event-Library  an,  die 
auf  elegante  Art  das  Problem  lost.  Die  Applikation  gibt  an,  auf  welches  oder  auf  welche 
Ereignisse  sie  warten  mochte.  Das  Betriebssystem  iiberwacht  Tastatur,  Maus  etc.  und 
gibt  in  dem  Moment  die  Kontrolle  an  die  Applikation  zuriick,  wenn  das  gewiinschte  Er- 
eignis  aufgetreten  ist.  Dies  hat  den  Vorteil,  daB  das  System  andere  Prozesse  laufen  lassen 
kann  (z.B.  den  Druckerspooler),  wenn  ein  Ereignis,  auf  das  man  wartet,  noch  nicht  einge- 
treten  ist. 


Wenn  eine  Applikation  nur  auf  ein  Ereignis  (z.B.  Tastatur)  wartet,  so  kann  es  auf  andere 
Ereignisse  nicht  reagieren  und  verpaBt  diese  sozusagen.  Zu  diesem  Zweck  kann  man  auch 
auf  eine  Kombination  von  Ereignissen  warten  (multiple  events).  Ruft  man  die  Funktion 
auf,  so  kehrt  sie  zuruck,  wenn  mindestens  eines  der  angegebenen  Ereignisse  eingetreten 
ist.  Die  meisten  GEM-Programm  benutzen  also  die  Funktion  evnt__multi,  um  auf  mehr- 
fache  Ereignisse  zu  warten. 


Folgende  Ereignisse  werden  von  der  Event  Library  unterstiitzt  (Parameter  und  Werte  der 
Argumente  lesen  Sie  bitte  in  irgendeinem  GEM-Funktionshandbuch  nach): 


- EVNT_KEYBD 


Durch  den  Aufruf  von  evnt_keybd  bekommt  man  Informationen  tiber  eine  Taste,  die 
gedruckt  wurde,  zuruck.  Sowohl  der  ASCII-Code  (niederwertiges  Wort)  als  auch  der 
Scan-Code  (hdherwertiges  Byte)  werden  zuriickgeliefert.  Um  den  Status  der  Shift-  und 
Alternate-Tasten  zu  bestimmen,  muB  die  Funktion  graf_mkstate  benutzt  werden. 
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Beispiel: 

key  = evnt_keybd  (); 

ascii.code  = key  & OxOOFF;  /*  untere  8 Bits  */ 
scan.eode  = key  » 8;  /*  obere  8 Bits  */ 


- EVNT_BUTTON 


Hiermit  kann  die  Applikation  auf  das  Drucken  oder  Loslassen  von  Mausknopfen  warten. 
Auch  kann  auf  das  Ereignis  Doppelklick  gewartet  werden.  Zusatzlich  kann  man  angeben, 
ob  auf  das  Drucken  oder  auf  das  Loslassen  von  Mausknopfen  gewartet  werden  soil.  Theo- 
retisch  werden  bis  zu  16  Mauskndpfe  unterstiitzt.  Ein  Ereignis  tritt  aber  nur  ein,  wenn 
mindestens  der  linke  Mausknopf  gedriickt  wird. 


- EVNT_MOUSE 

Werden  in  einer  Applikation  verschiedene  Bildschirmfenster  benutzt,  so  kommt  es  vor, 
dab  fiir  die  verschiedenen  Fenstertypen  das  Aussehen  der  Maus  geandert  werden  soli. 
In  einer  Textverarbeitung  konnte  die  Maus  von  einem  Pfeil  zu  einem  Textcursor  (vertika- 
le  Linie)  verandert  werden.  In  einem  Grafikprogramm  benutzt  man  haufig  ein  Faden- 
kreuz.  In  der  Beispielapplikation  SCRAP  wird  z.B,  die  Mausform  des  Textfensters  ge- 
andert. 

Beim  Aufruf  der  Funktion  wird  das  Rechteck  iibergeben,  bei  dessen  Ein-  oder  Austritt 
der  Maus  ein  Ereignis  stattfinden  soil. 


- EVNT  MESAG 


Wie  schon  welter  oben  erwahnt,  besteht  das  GEM-System  aus  mehreren  Prozessen  (Be- 
nutzerprogramm,  Accessories,  Bildschirmmanager) . Diese  Prozesse  miissen  untereinan- 
der  Nachrichten  austauschen  konnen.  Einer  der  wichtigsten  Prozesse  ist  der  Bildschirm- 
manager. Er  wird  immer  dann  aktiv,  wenn  die  Maus  in  die  Menuzeile  bewegt  wurde  oder 
mit  den  Randkomponenten  eines  Fensters  Aktionen  durchgefiihrt  wurden  (z.B.  Verschie- 
ben/Vergrdfiern  eines  Fensters). 

Der  Bildschirmmanager  sendet  der  Applikation,  zu  der  das  oberste,  aktive  Fenster  ge- 
hort,  Nachrichten.  Diese  sogenannten  Standardnachrichten  konnen  mit  der  Funktion 
evnt_mesag  gelesen  werden.  Die  Nachrichten  haben  immer  eine  Lange  von  16  Bytes 
und  sind  in  Worten  organisiert.  In  C-Schreibweise  konnte  man  sie  wie  folgt  definieren: 


WORD  msgbuf  [8]; 
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Die  einzelnen  Felder  haben  folgende  Bedeutung: 


msgbuf  [0] 
msgbuf  [1] 
msgbuf  [2] 


msgbuf  [3] 


Typ  der  Nachricht 

Applikationskennung  (ap_id)  des  Absenders 

Lange  der  Nachricht  (ohne  die  16  Bytes).  1st  die  Nachricht  langer  als 
0 (>  0)  so  muB  mit  der  Funktion  appLread  der  Rest  der  Nachricht  gele- 
sen  werden. 

msgbuf  [7]  = Abhangig  vom  Typ  der  Nachricht 


Entsprechend  dem  Typ  der  Nachricht  muB  die  Applikation  reagieren.  Wurde  z.B.  ein 
Meniipunkt  angeklickt,  so  sollte  zum  Menu-Handler  gesprungen  werden,  der  den  Rest 
der  Nachricht  verarbeitet  (siehe  Beispielprogramm  SCRAP). 


Folgende  Standardmeldungen  konnen  in  msgbuf  [0]  auftreten: 


a)  MN_SELECTED 

Der  Benutzer  hat  einen  Meniipunkt  mit  der  Maus  angewahlt.  Die  Feldelemente  msgbuf 
[3]  bzw.  msgbuf  [4]  enthalten  den  Index  des  Meniipunktes  im  Objektbaum  der  Menii- 
leiste. 

b)  WM_REDRAW 

Durch  Fensteraktionen  ist  ein  Zustand  eingetreten,  der  dazu  fiihrt,  daB  der  Fensterinhalt 
der  Applikation  neu  gezeichnet  werden  muB.  Man  bekommt  die  Kennung  des  Fensters 
sowie  Position,  Breite  und  Hohe  des  Fensters  zuriick. 


c)  WM_TOPPED 

Ein  Fenster  wurde  aktiviert  (nach  oben  gebracht).  Zuriickgegeben  wird  die  Kennung 
(window  handle)  des  Fensters. 

d)  WM_CLOSED 

Ein  Fenster  wurde  geschlossen.  Es  wird  durch  die  Kennung  identifiziert. 

e)  WM  FULLED 

Wenn  der  Benutzer  auf  die  VergroBerungsbox  eines  Fensters  geklickt  hat,  wird  diese 
Meldung  zusammen  mit  der  Kennung  des  Fensters  vom  Bildschirmmanager  an  die  Appli- 
kation gesendet. 

f)  WM_ARROWED 

Klickt  der  Benutzer  auf  einen  der  Pfeile  in  einem  Fenster  oder  den  Bereich  der  Schieber, 
so  wird  diese  Nachricht  gesendet.  Im  msgbuf  [4]  steht  dann  genau,  wohin  der  Benutzer 
geklickt  hat. 
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g)  WM_HSLIDE 

Diese  Nachricht  wird  gesendet,  wenn  der  Benutzer  den  horizontalen  Schieber  eines  Fen- 
sters  bewegt  hat. 

h)  WM_VSLIDE 

Diese  Nachricht  wird  gesendet,  wenn  der  Benutzer  den  vertikalen  Schieber  eines  Fensters 
bewegt  hat. 

i)  WM_SIZED 

Wurde  vom  Benutzer  die  GroBe  eines  Fensters  verandert,  so  wird  diese  Nachricht  an  die 
Applikation  gesendet.  Die  neue  Breite  und  Hohe  des  Fensters  werden  ebenfalls  in  der 
Nachricht  angegeben. 

j)  WM_MOVED 

Wurde  vom  Benutzer  die  Position  eines  Fensters  verandert,  so  wird  diese  Nachricht  an 
die  Applikation  gesendet.  Die  neuen  x-  und  y-Werte  des  Fensters  werden  ebenfalls  in  der 
Nachricht  angegeben. 

11.  WM_UNTOPPED 

Wird  das  oberste  Fenster  durch  das  Nachobenbringen  eines  anderen  Fensters  inaktiv,  so 
wird  diese  Nachricht  gesendet.  Die  Applikation  hat  dann  noch  die  Moglichkeit  das  Innere 
des  Fensters  zu  retten,  falls  dies  notig  ist  (z.B.  bei  einem  Grafikprogramm,  das  die  er- 
zeugte  Grafik  zunachst  im  Bildschirm  puffert). 

12.  AC_OPEN 

Klickt  ein  Benutzer  in  das  Accessory-Menu  und  wahlt  damit  ein  Accessory  aus,  so  wird 
diese  Meldung  an  alle  Accessories  gesendet.  Durch  den  Bezeichner,  der  mitgesendet 
wird,  kann  entschieden  werden,  ob  die  Meldung  fiir  Ihr  Accessory  bestimmt  ist. 

13.  AC_CLOSE 

Diese  Meldung  wird  gesendet,  wenn  die  Hauptapplikation  verlassen  wird  oder  der  Bild- 
schirm geloscht  werden  soil.  Das  Accessory  sollte  dann  samtliche  Fenster  freigeben,  die 
es  geoffnet  hatte. 

14.  Andere  Meldungen 

Im  GEM-System  unter  MS-DOS  existiert  das  Accesory  CALCLOCK. ACC.  Es  beinhaltet 
einen  Taschenrechner,  eine  Uhr  und  einen  Druckerspooler.  Der  Druckerspooler  druckt 
Dateien  im  Hintergrund.  Die  Dateien  miissen  fertig  formatiert  sein  und  werden  Byte  fur 
Byte  vom  Spooler  an  den  Drucker  gesendet.  Das  Programm  OUTPUT  benutzt  den  Spoo- 
ler, wenn  man  „Druck  auf  Datei“  anwahlt.  Man  kann  dort  „Im  Hintergrund  drucken" 
angeben.  Das  OUTPUT  sendet  dann  eine  Nachricht  an  den  Spooler,  die  wie  folgt 
aussieht: 
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msgbuf  [0]  = 100 

msgbuf  [1]  = Applikationskennung  (ap_id)  des  Absenders 
msgbuf  [2]  = - 1 

msgbuf  [3]  = Lange  des  Dateinamens 
msgbuf  [4]  - msgbuf  [5]  = Adresse  des  Dateinamens 
msgbuf  [6]  = Anzahl  der  Kopien 
msgbuf  [7]  = 0;  Datei  nach  Drucken  nicht  loschen 
1:  Datei  nach  Drucken  loschen 


Der  Spooler  sendet  nach  dem  Empfangen  der  Nachricht  die  Quittung  an  den  Sender,  die 
wie  folgt  aussieht: 

msgbuf  [0]  = 101; 

msgbuf  [1]  = Kennung  des  Spooler  (ap_id) 
msgbuf  [2]  - msgbuf  [7]  = 0; 

Beispiel:  Wir  wollen  die  Datei  DRUCK.TXT  auf  der  Scrapdirectory  uber  den  System- 
spooler  ausdrucken.  Der  Systemspooler  ist  ein  Accessory  mit  Dateinamen  CAL- 
CLOCK.ACC. 


BYTE  filename  [80]; 
WORD  ap_id,  spool_id; 
WORD  msgbuf  [8]; 


ap_ld  = appl_lnit  ();  /*  eigene  Kennung  */ 
spool_id  = appl.find  ("CALCLOCK") ; 
scrp_read  (filename); 
street  (filename,  "DRUCK.TXT"); 


If  (spool_ld  >=  0) 

[ 

msgbuf  [0]  = 100; 

msgbuf  [1]  = ap_ld; 

msgbuf  [2]  = -1; 

msgbuf  [3]  = strlen  (filename); 

msgbuf  [4]  = (WORD) ((LONG) filename  & OxFFFF) ; /*  low  word  »/ 

msgbuf  [5]  = (WORD)  ( (LONG)  (filename)  » 16);  high  word  */ 

msgbuf  [6]  = 1; 

msgbuf  [7]  = 1; 


appl.wrlte  (spool_ld,  16,  msgbuf); 
evnt_mesag  (msgbuf) ; 
ok  = msgbuf  [0]  ==  101; 
j /*  If  */ 
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In  obigem  Beispiel  wird  zuerst  unsere  eigene  Applikation  initialisiert  (appLinit),  wobei 
wir  unsere  Kennung  (ap_id)  erhalten.  Danach  suchen  wir  die  Kennung  des  Spoolers 
CALCLOCK.  1st  diese  Kennung  groBer  oder  gleich  0,  so  konnen  wir  deni  Spooler  eine 
Nachricht  senden.  Der  msgbuf  wird  entsprechend  vorbelegt.  Durch  appl_write  wird 
die  Nachricht  gesendet,  Wir  warten  dann  sofort  auf  die  Quittung  des  Spoolers 
(evnt_mesag).  Die  Quittung  ist  korrekt,  wenn  msgbuf  [0]  den  Wert  101  hatte. 

Achtung!  Das  oben  beschriebene  Handshaking  (appl_write,  evnt_mesag)  funktioniert 
nur,  wenn  der  Bildschirmmanager  seine  Arbeit  verrichten  kann,  da  er  ja  als  parallel  lau- 
fender  ProzeB  alle  Aktivitaten  iiberwacht.  Er  ist  dann  aktiv,  wenn  die  Funktion 
wind_update  (END_UPDATE)  aufgerufen  wurde,  falls  vorher  ein  wind_update 
(BEG_UPDATE)  gemacht  wurde.  AuBerdem  miissen  bei  einem  68000-System  die 
Werte  msgbuf  [4]  und  [5]  vertauscht  werden. 

Falls  ein  Softwarehaus  oder  eine  Privatperson  einen  Systemspooler  fur  den  ATARI  ST 
entwickeln  mochte,  so  halte  es  sich  bitte  strikt  an  o.a.  Nachrichtenprotokoll  und  an  den 
Programmnamen  (CALCLOCK. ACC).  Dann  sind  alle  Programme,  die  diesen  Spooler 
benutzen,  kompatibel  zu  den  verschiedenen  GEM-Versionen. 


- EVNT_TIMER 

Manchmal  ist  es  notig,  eine  bestimmte  Zeit  warten  zu  miissen  (z.B.  2 Sekunden).  Dies 
kann  man  natiirlich  durch  standiges  Auslesen  der  Rechneruhr  bewerkstelligen.  Dadurch 
wird  aber  wertvolle  Rechenzeit  vergeudet.  Ein  Aufruf  von  evnt_timer  verhindert  dies. 
Man  gibt  an,  wieviele  Millisekunden  man  warten  mochte  und  bekommt  naeh  Ablauf  der 
Zeit  die  Nachricht  vom  Typ  MU_TIMER  in  den  Naehrichtenpuffer. 


- EVNT_MULTI 

Wie  schon  weiter  oben  erwahnt,  ist  es  oft  notig,  auf  mehrere  Ereignisse  gleichzeitig  war- 
ten  zu  miissen,  um  keines  der  Ereignisse  zu  verpassen.  Zu  diesem  Zweck  gibt  es  die  AES- 
Funktion  evnt_multi.  Dort  kann  man  auf  eine  Kombination  aller  eben  beschriebenen 
Ereignisse  warten.  Deshalb  ist  die  Funktion  evnt„multi  die  zentrale  Warteschleife  auf 
Benutzeraktionen  in  einem  Dialogsystem.  Sie  findet  sich  in  jedem  groBeren  GEM- 
Programm  und  sollte  immer  benutzt  werden. 


- EVNT_DCLICK 


Durch  Aufruf  von  evnt_dclick  kann  die  Geschwindigkeit  eingestellt  werden,  innerhalb 
der  ein  Doppelklick  der  Mans  durchgefuhrt  werden  muB.  Die  Werte  reichen  von  0 (lang- 
sam)  bis  4 (schnell).  . 
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3.  MENU-LIBRARY  I 

30  — menu_bar 

Meniizeile  anzeigen/ldschen 

31  — menu_icheck 

Check-Hakchen  setzen/loschen 

32  — menu_ienable 

Meniieintrage  grau/normal  darstellen 

33  - menu__tnormal 

Meniieintrage  invers/normal  darstellen 

34  — menu_text 

Text  in  Meniieintrag  andern 

35  - menu_register 

Desk-Accessory  anmelden 

36  — menu_unregister 

Desk-Accessory  abmelden 

37  — menu  click 

Einstellung  von  Drop-Down/Pull-Down-Meniis 

Menuzeilen  erscheinen  am  oberen  Bildschirmrand  eines  GEM-Programmes.  Sie  konnen 
auch  in  einem  Fenster  erscheinen  (durch  Benutzen  des  Programmes  SCRAP),  was  weite- 
re  Aktionen  ermdglicht.  Menuzeilen  werden  mil  dem  RCS  erstellt  und  konnen  nach  dem 
Laden  (rsrc_load)  mil  einem  einzigen  Befehl  installiert  werden  (menu_bar). 

Ab  diesem  Zeitpunkt  iibernimmt  der  Bildschirmmanager  die  Verwaltung  der  Meniizeile. 
Fahrt  ein  Benutzer  mit  der  Maus  in  die  obere  Bildschirmzeile,  so  laBt  der  Manager  das 
Menii  herunterklappen,  wobei  der  Benutzer  einzelne  Meniipunkte  anfahren  und  anklicken 
kann.  Tut  er  dies,  so  sendet  der  Bildschirmmanager  die  Nachricht,  welches  Menii  ange- 
wahlt  wurde.  Dazu  befinden  sich  im  Nachrichtenpuffer  der  Typ  MN_SELECTED  so- 
wie  die  Indizes  des  Drop-Down-Meniis  und  des  angeklickten  Meniieintrages.  Diesen  Indi- 
zes  wurden  im  Resource-Construction-Set  Namen  gegeben  (Konstanten  in  C),  so  daB  man 
vom  Programm  aus  mit  den  C-Namen  arbeiten  kann. 

Meniieintrage,  die  nicht  angewahlt  werden  sollen,  konnen  grau  (disabled)  dargestellt  wer- 
den. Links  neben  Meniieintragen  konnen  Hakchen  (check  marks)  gesetzt  und  geldscht 
werden. 


- MENU_BAR 

Damit  wird  die  Meniizeile  fur  eine  Applikation  (oder  fiir  ein  Desk-Accessory  ab  GEM 
2.X)  eingerichtet.  Die  Meniizeile  wird  sichtbar  und  kann  vom  Benutzer  angefahren  wer- 
den. Man  kann  die  Menuzeile  auch  wieder  entfernen,  was  vor  dem  Beenden  der  Applika- 
tion geschehen  sollte. 


- MENU_ICHECK 

Hakchen  vor  Menueintragen  konnen  mit  dieser  Funktion  gesetzt  und  wieder  geloscht  wer- 
den. Man  muB  selbst  darauf  achten,  daB  man  beim  Erstellen  der  Meniieintrage  (am  be- 
sten)  2 Leerzeichen  vor  jeden  Meniieintrag  setzt,  um  Platz  fiir  ein  Hakchen  zu  reser- 
vieren. 
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- MENU_IENABLE 

Sollen  Meniieintrage  nicht  anwahlbar  sein,  so  muB  dies  vom  Bildschirmmanager  erkannt 
werden.  Dazu  benutzt  man  die  Funktion  menu_ienable,  die  Meniieintrage  grau  (in 
schwacher  Schrift)  erscheinen  laBt.  Soli  ein  Menupunkt  wieder  anwahlbar  sein,  so  kann 
dies  ebenfalls  mit  der  gleichen  Funktion  bewerkstelligt  werden. 


- MENU_TNORMAL 

Wurde  ein  Menupunkt  angewahlt,  so  erscheint  die  dazugehdrige  Meniiiiberschrift  in  in- 
verser  Schrift.  Dies  wird  vom  Bildschirmmanager  erledigt.  Nach  dem  Ausfuhren  der 
Funktion,  die  vom  Benutzer  angewahlt  wurde,  muB  die  Uberschrift  wieder  auf  Normal- 
schrift  geandert  werden.  Gibt  der  Benutzer  einen  Befehl  tiber  Tastatur  ein,  und  entspricht 
dieser  Befehl  dem  Anwahlen  eines  Meniipunktes,  so  sollte  die  entsprechende  Uberschrift 
in  vers  dargestellt  werden.  Ein  Aufruf  von  menu_tnormal  iibernimmt  das  inverse  und 
normale  Anzeigen  von  Meniiuberschriften. 


- MENU_TEXT 

Mit  dieser  Funktion  kann  der  Text  von  Meniieintragen  zur  Laufzeit  geandert  werden. 
Man  gibt  den  Objektbaum,  die  Objektnummer  sowie  die  Adresse  des  neuen  Textes  an. 
Der  neue  Text  darf  nicht  langer  als  der  alte  sein,  da  sonst  Speicher  uberschrieben  wird. 

Interessant  ist  folgende  Tatsache:  Man  kann  auch  Texte  von  Desk-Accessories  andem, 
indem  man  in  der  Variablen  tree  nicht  die  Adresse  des  Objektbaumes  iibergibt,  sondern 
im  hoherwertigen  Wort  eine  0 und  im  niederwertigen  Wort  die  ProzeBkennung  (process 
id)  iibergibt,  die  man  durch  einen  Aufruf  von  menu_register  erhalt. 


- MENU_REGISTER 

- MENU_UNREGISTER 

Hiermit  kann  ein  Desk- Accessory  angemeldet  werden.  Man  iibergibt  die  Kennung  der 
Applikation  (durch  appl_init)  und  die  Zeichenkette,  die  im  Meniieintrag  erscheinen 
soil.  Man  erhalt  eine  Kennung  von  0 bis  5 (6  Accessories  sind  moglich),  mit  der  man 
sein  eigenes  Desk- Accessory  identifizieren  kann. 

Um  ein  Desk-Accessory  aus  der  Meniileiste  zu  entfernen,  wird  die  Funktion 
menu_unregister  benutzt,  die  ab  GEM  2.X  zur  Verfugung  steht.  Viel  Sinn  hat  dies 
nicht,  da  der  Speicherplatz,  den  das  Accessory  belegt,  ja  nicht  mehr  freigegeben  wird. 
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- MENU_CLICK 

Ab  GEM/3  steht  diese  Funktion  zur  Verfugung.  Damit  kann  eingestellt  werden,  ob  man 
Drop-Down-Meniis  (klappen  herunter,  wenn  die  Mans  in  die  Meniizeile  kommt)  oder 
Pull-Down-Meniis  (klappen  erst  herunter,  wenn  man  mit  der  Maus  in  einen  Meniititel 
klickt)  haben  mbchte. 

Zwei  Parameter  miissen  ubergeben  werden; 

click:  FALSE  = Drop-Down-Menus 
TRUE  = Pull-Down-Meniis 

setit:  FALSE  = Einstellung  abfragen 

TRUE  = Neue  Einstellung  setzen 

Beispiel;  Die  Applikation  bestimmt  Pull-Down-Meniis. 

click  = TRUE; 
setit  = TRUE; 

raenu_click  (click,  setit); 


4.  OBJECT-LreRARY 


40 

- objc_add 

Objekte  an  Baum  anhangen 

41 

— objc_delete 

Objekte  aus  Baum  Ibschen 

42 

- objc  draw 

Objek  Oder  Baum  zeichnen 

43 

— objc_find 

Bestimmung  Maus/Objektposition 

44 

- objc_offset 

Objektposition  errechnen 

45 

— objc_order 

Objekte  im  Baum  bewegen 

46 

- objc_edit 

Text  in  Objekt  editieren 

47 

— objc_change 

Status  eines  Objektes  andern 

Der  Aufbau  eines  Objektbaumes  wurde  vor  allem  in  unserem  Buch  „Softwareentwick- 
lung  auf  dem  ATARI  ST“  ausfuhrlichst  erlautert.  Aus  diesem  Grunde  werden  wir  nur 
noch  einmal  kurz  auf  Objektbaume  eingehen  und  nur  die  Dinge  erlautem,  die  neu  sind 
Oder  in  keinem  Buch  gut  erklart  wurden. 

Objektbaume  werden  mit  dem  Resource-Construction-Set  erstellt.  Sie  konnen  z.B.  Menii- 
zeilen  und  Dialogboxen  sein,  also  all  diejenigen  Elemente  auBer  Bildschirmfenstern,  die 
Sie  in  alien  GEM-Programmen  schon  einmal  kennengelernt  haben.  In  einem  Baum  gibt 
es  meist  eine  Wurzel  und  Objekte  unter  dieser  Wurzel  (sogenannte  Kinderobjekte).  ledes 
der  Kinderobjekte  kann  wieder  Kinderobjekte  haben.  So  entsteht  eine  Hierarchie  wie  in 
Abbildung  2.16. 
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Abb.  2.16:  Stniktur  eines  Objektbaumes 


In  der  Abbildung  sieht  man  z.B.  eine  Dialogbox  mit  17  Objekten.  Die  weiBe  Hintergrund- 
box  ist  die  Wurzel  des  Bauraes  (ROOT).  Darin  befinden  sich  16  Objekte  (Cl  — C16). 
C2  selbst  ist  wieder  eine  Box,  die  3 Objekte  enthalt  (C3  - C5).  Die  Objekte  C6  bis  C14 
konnten  z.B.  Zeichenketten  oder  Piktogramme  sein.  Die  beiden  Objekte  C15  und  C16 
konnte  man  sich  als  OK-  und  Abbruch-Knopfe  vorstellen. 

Objekte  werden  intern  in  einem  Feld  vom  Typ  OBJECT  (siehe  AES.H)  abgelegt.  In  C- 
Schreibweise  konnte  man  einen  Objektbaum  wie  folgt  definieren: 


typedef  struct  object 
( 


WORD 

ob_next; 

/*  -> 

object's  next  sibling 

*/ 

WORD 

ob_head; 

/*  -> 

head  of  object's  children 

*/ 

WORD 

ob.tall; 

/»  -> 

tail  of  object's  children 

*/ 
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DWORD 

ob_type; 

/* 

type  of  object-  BOX,  CHAR,  . 

..  V 

DWORD 

ob_flags; 

/* 

flags 

*/ 

DWORD 

ob_state; 

/* 

state-  SELECTED,  CROSSED,  .. 

• */ 

LONG 

ob_spee; 

/* 

"out"-  ->  anything  else 

*/ 

WORD 

ob_x; 

/* 

upper  left  corner  of  object 

*/ 

WORD 

ob_y; 

/* 

upper  left  corner  of  object 

*/ 

WORD 

ob_width; 

/* 

width  of  object 

*/ 

WORD 

ob_height; 

/* 

height  of  object 

*/ 

OBJECT; 

OBJECT  ^dialog; 

Die  Elemente  des  Feldes  sind  die  einzelnen  Objekte.  So  steht  das  Wurzelobjekt  an  erster 
Stelle: 

Wurzel  = dialog  [0] 

1.  Kind  = dialog  [1] 
n.  Kind  = dialog  [n] 

usw. 

Jedem  Objekt  kann  im  Resource-Construction-Set  ein  Name  gegeben  werden,  wenn  dies 
notig  ist.  So  wird  man  dem  Wurzelobjekt  in  obigem  Beispiel  den  C-Namen  (Konstante) 
DIALOG  geben,  wahrend  man  etwa  dem  OK-Knopf  den  Namen  DOK  (Dialog  OK),  dem 
Abbruch-Knopf  den  Namen  DCANCEL  gibt. 

Die  Variable  dialog  ist  zu  diesem  Zeitpunkt  noch  nicht  gefixllt.  Man  tut  dies,  nachdem 
man  seine  Objekte  geladen  hat  (rsrc_load).  AnschlieBend  kann  man  mit  dem  Namen  der 
Objekte  auf  jedes  einzelne  Objekt  zugreifen. 

Beispiel: 
appl_init  (); 

rsrc^load  ( "SHOWGEM . RSC" ) ; 
rsrc_gaddr  (RTREE,  DIALOG,  Sdialog) ; 

Die  Variable  dialog,  die  auf  das  Wurzelobjekt  unseres  Objektbaumes  zeigt,  ist  jetzt  ge- 
setzt.  Auf  jedes  einzelne  Objekt  dieses  Baumes  kann  z.B.  wie  folgt  zugegriffen  werden; 

status  = dialog  [DCANCEL]. ob_state; 

Jedes  Objekt  wird  durch  einige  Werte  gekennzeichnet,  so  daB  sich  ein  Objektbaum  als 
Feld  von  Strukmren  (array  of  record)  ergibt.  Wie  man  an  obiger  Definition  des  Typs  OB- 
JECT sieht,  sind  die  Objekte  uber  die  Felder  ob_next,  ob_head  und  ob_tail  miteinan- 
der  verzeigert,  was  aber  meist  nicht  interessiert. 
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Im  Feld  ob_type  steht  der  Typ  des  Objekts  (siehe  AES.H).  Dort  wird  z.B. 
G_BUTTON  (Knopf),  G_STRING  (Zeichenkette),  G_ICON  (Piktogramm)  usw.  ein- 
getragen. 


Das  Feld  ob_flags  sagt,  ob  das  Objekt  selektiert  werden  darf  (SELECTABLE),  ob  es 
versteckt  1st  (HIDETREE)  und  vieles  mehr. 


Im  Feld  ob_state  wird  der  Status  eines  Objektes  abgelegt.  Dort  befinden  sich  Werte  wie 
„es  wurde  selektiert"  (SELECTED),  „es  ist  grau  dargestellt"  (DISABLED)  usw. 


In  den  Feldem  ob_x,  ob_y,  ob_width  und  ob_height  werden  die  Koordinaten  des  Ob- 
jektes relativ  zum  Vaterobjekt  bzw.  zum  Bildschirm  (wenn  es  sich  urn  das  Wurzel-  oder 
Root-Objekt  handelt)  abgelegt.  Nach  dem  Laden  durch  rsrc_load  sind  diese  Werte  Ra- 
sterkoordinaten werte.  Solange  sie  sich  in  der  Resource-Datei  befinden,  werden  die  Werte 
durch  Vielfaches  von  Einzelzeichen  (character  width)  gekennzeichnet. 


Das  Feld  ob_spec  hat  eine  ganz  besondere  Bedeutung.  Je  nach  Typ  des  Objektes  kann 
der  Inhalt  variieren.  Ist  der  Typ  z.B.  G_STRING,  also  eine  Zeichenkette,  so  zeigt  der 
ob_spec-Wert  auf  die  Zeichenkette,  da  sie  selbst  ja  nicht  in  der  Objekt-Struktur  unter- 
gebracht  werden  kann.  Ist  der  Typ  z.B.  G_ICON,  also  ein  Piktogramm,  so  zeigt  der 
ob_spec-Wert  auf  die  Beschreibung  des  Piktogrammes  (ICONBLK-Struktur)  usw.  Die 
Strukturen,  auf  die  ob_spec  verweisen,  sind  in  der  Datei  AES.H  definiert.  In  der  fol- 
genden  Tabelle  werden  zu  jedem  Objekttyp  die  ob_spec-Werte  erlautert; 


ob_type  ob_spec-Wert 


G_BOX 

Farbe  und  Breite  des  Randes 

G_TEXT 

Zeiger  auf  TEDINFO-Struktur 

G_BOXTEXT 

Zeiger  auf  TEDINFO-Struktur 

G_IMAGE 

Zeiger  auf  BITBLK-Struktur 

G_USERDEF 

Zeiger  auf  APPLBLK_Struktur 

G_IBOX 

Farbe  und  Breite  des  Randes 

G_BUTTON 

Zeiger  auf  Zeichenkette 

G_BOXCHAR 

Zeichen,  Farbe  und  Breite  des  Randes 

G_STRING 

Zeiger  auf  Zeichenkette 

G_FTEXT 

Zeiger  auf  TEDINFO-Struktur 

G_FBOXTEXT 

Zeiger  auf  TEDINFO-Struktur 

G_ICON 

Zeiger  auf  ICONBLK-Struktur 

G_TITLE 

Zeiger  auf  Zeichenkette 

Der  Objektstatus  ob_state  gibt  an,  ob  z.B.  ein  Objekt  selektiert  wurde  (SELECTED). 
Durch  die  einfache  Abfrage 
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If  {dialog  [KNOPF] .ob.state  & SELECTED) 
...weitere  Aktionen 


kann  z.B.  gepruft  werden,  ob  ein  Objekt  mit  der  Maus  angewahlt  wurde.  In  obigem  Bei- 
spiel  wurde  ein  Objekt  mit  Namen  KNOPF  selektiert. 

Neue  Objektstati  ab  GEM  2.X  sind: 

WHITEBAK  (0  x 0040)  und 
DRAW3D  (0x0080) 

Beide  Stati  werden  nur  bei  Objekten  vom  Typ  G_ICON  benutzt.  1st  WHITEBAK  ge- 
setzt  und  befindet  sich  das  Piktogramm  auf  einer  weiBen  Flache,  so  wird  die  Maske  des 
Piktogrammes  nicht  gezeichnet.  Durch  Setzen  des  Status  spart  sich  das  VDI  bei  der  Aus- 
gabe  wertvolle  Zeit. 

Sind  die  beiden  Bits  DRAW3D  und  SELECTED  im  Objektstatus  gesetzt,  so  wird  die 
Maske  3-mal  gezeichnet.  Einmal  an  der  angegebenen  Position  und  jeweils  1-mal  um  1 
Pixel  nach  links  oben  und  rechts  unten  versetzt.  Es  ergibt  sich  dann  eine  leicht  dreidimen- 
sionale  Darstellung. 


— Benutzerdefinierte  Objekte 

An  dieser  Stelle  soil  eine  wichtige  Erweiterungsmoglichkeit  fiir  Objekttypen  erklart  wer- 
den. Es  handelt  sich  um  benutzerdefinierte  Objekte.  Sie  sind  vom  Typ  G USERDEF 
und  wurden  von  den  GEM-Systementwicklem  eingebaut,  um  dem  AES  ein  Hintertiirchen 
ffir  Erweiterungen  frei  zu  halten.  Jeder  kennt  die  Standardobjekte  aus  Dialogboxen:  Zei- 
chenketten,  Knbpfe,  Piktogramme,  Radio-Knopfe  usw.  Solche  Objekte  konnen  im 
Resource-Construction- Set  erzeugt  und  abgespeichert  werden.  Der  Vorteil  einer  Dialog- 
box  liegt  ganz  einfach  darin,  sie  mit  einem  Befehl  zeichnen  zu  konnen  (objc_draw)  und 
das  gesamte  Handling  durch  den  AES-Befehl  form_do  abhandeln  zu  lassen.  Man 
braucht  sich  dann  bei  der  Eingabe  in  eine  Dialogbox  um  nichts  mehr  zu  kiimmern. 

Nun  reichen  uns  die  Standardobjekte,  die  vom  AES  angeboten  werden,  aber  nicht.  Wir 
mochten  Dialogboxen  mit  runden  Knopfen  und  ankreuzbaren  Kastchen  haben.  Solche 
Objekte  werden  auf  einem  Apple  Macintosh  und  unter  Microsoft-Windows  bzw.  dem 
Presentation  Manager  ja  auch  angeboten.  Zu  diesem  Zweck  legen  wir  uns  einfach  neue 
Typen  an.  Im  Feld  ob_type  eines  OBJECT-Typs  wird  vom  AES  nur  das  untere  Byte  be- 
nutzt. Das  hbherwertige  Byte  kann  von  der  Applikation  frei  belegt  werden.  Wir  haben 
also  die  Mbglichkeit,  255  neue  Objekttypen  zu  defmieren. 

Wir  benutzen  im  SCRAP-Programm  fiir  3 neue  Objekttypen  aber  die  unteren  5 Bits  nicht, 
da  sie  bei  einer  neuen  Eingaberoutine  (form  do)  gebraucht  werden.  So  bleiben  3 Bits 
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iibrig,  mit  denen  8 neue  Objekttypen  definiert  werden  konnen.  3 davon  sind: 


# define  DHEADER  0x20 

# define  DCHECKBOX  0x40 

# define  DRBUTTON  0 X 60 


- Uberschr if t 

^ Check  Bok  I 
^ Check  Bok  2 
® Radio  Button  1 
O Radio  Button  2 


EHIT 


Abb.  2.17:  Diaiogbox  mit  neuen  Objekttypen 


DHEADER  ist  eine  Uberschrift,  die  z.B,  mit  einem  Rahmen  am  besten  benutzt  werden 
kann.  Objekte  von  diesem  Typ  werden  im  Objektbaum  um  eine  halbe  Zeichensatzhohe 
nach  oben  geschoben. 

DCHECKBOX  sind  ankreuzbare  Boxen.  Ist  das  Objekt  selektiert  (SELECTED),  so  er- 
scheint  eine  gekreuzte  Linie  in  einem  Rahmen.  Ist  es  nicht  selektiert,  erscheint  nur  der 
Rahmen.  Sowohl  der  Rahmen  der  Linie  (Linienfarbe)  als  auch  das  innere  Kreuz  (Fullmu- 
sterfarbe)  konnen  im  RCS  farblich  getrennt  eingestellt  werden  (z.B.  griine  Box  mit  rotem 
Kreuz). 

DRBUTTON  sind  runde  Radio-Knopfe  wie  auf  einem  Apple-Macintosh.  Es  sind  kleine 
Piktogramme,  die  an  der  entsprechenden  Stelle  gezeichnet  werden.  Rund  sind  die  Kndpfe 
allerdings  nur,  wenn  der  Bildschirm  in  etwa  ein  Auflosungsformat  von  1 ; I hat,  wie  dies 
beim  ATARI  ST  der  Fall  ist.  In  einer  Aufldsung  von  640x2(X)  z.B.  sind  die  Kndpfe  auch 
rund,  da  dort  entsprechend  verzerrte  Piktogramme  (RBLNORM,  RBLSEL)  benutzt  wer- 
den. Auch  sie  konnen  farbig  sein.  Dazu  stellt  man  das  Fiillmuster  im  RCS  auf  die  entspre- 
chende  Farbe  ein. 
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EHtended 
Type  64 


EHtended  Type  32 


EHtended  Type  96 


Abb.  2,18:  Herstellung  der  neuen  Objekttypen 


Die  Frage  erhebt  sich,  wie  man  solche  Objekte  im  RCS  berstellt.  Zunacbst  gibt  es  diese 
Objekte  nicbt  als  Grundtyp.  Dehalb  benutzen  wir  fur  Uberscbriften  z.B.  den  Typ 
G TEXT  (G  STRING  funktioniert  in  unserem  Beispiel  allerdings  nicbt,  da  Strings 
nicbt  im  Replace-Modus  gezeichnet  werden).  Jeder  andere  Typ  funktioniert  aber  auch, 
da  nur  die  y-Position  des  Objektes  verandert  wird.  Die  Zeicbenkette  fiir  die  Uberscbrift 
legen  wir  in  eine  Box  direkt  an  den  oberen  Rand.  Beim  Text  lassen  wir  aus  asthetiscben 
Griinden  links  und  recbts  eine  Leerstelle  frei  (siehe  Abb.  2. 17).  Nun  mussen  wir  nur  noch 
den  erweiterten  Typ  32  (Hex  0x20)  im  oberen  Byte  von  ob_type  eintragen.  Auf  dem 
ATARI  ST  kann  dies  durcb  direkte  Eingabe  gemacbt  werden.  Auf  dem  PC  mit  dem  RCS 
geht  es  erst  ab  der  Version  2.2.  Fiir  alle  diejenigen,  die  nicbt  die  Moglicbkeit  haben, 
packen  wir  auf  die  Diskette  die  Resoure-Datei  aus  obiger  Abbildung.  Man  kann  sicb  dann 
die  gewiinscbten  neuen  Objekte  einfach  berauskopieren. 

Um  eine  neue  Checkbox  zu  erstellen,  nebmen  wir  einfacb  ein  Objekt  vom  Typ  G_BOX 
(weifie  Box)  und  positionieren  es  an  die  gewiinscbte  Stelle.  Wir  stellen  die  Rabmenfarbe 
und  das  Fiillmuster  auf  scbwarz  oder  eine  andere  beliebige  Farbe.  Der  erweiterte  Typ 
wird  auf  64  (Hex  0x40)  gestellt.  Das  Bit  SELECTABLE  muB  naturlicb  gesetzt  werden. 
Die  Box  kann  beliebig  vergrbBert  werden. 

Beim  neuen  Radio-Knopf  benutzen  wir  die  gleiche  Metbode  wie  bei  der  Checkbox.  Hier 
stellen  wir  den  erweiterten  Typ  auf  96  (Hex  0x60).  Radio-Knopfe  haben  immer  eine  Gro- 
6e  von  12x12  Pixel,  da  in  Wirklichkeit  ein  Piktogramm  gezeichnet  wird.  Deshalb  niitzt 
es  nichts,  wenn  die  Box  groBer  gemacbt  wird. 

Wie  geht  das  Benutzen  von  eigenen  Objekttypen  im  AES  jetzt  also  vor  sich?  Dazu  sehen 
wir  uns  die  beiden  Strukturen  (AES.H)  USERBLK  und  PARMBLK  an. 

typedef  struct  user.blk 

[ 

WORD  ()tub_code)  ();  /*  pointer  to  drawing  function  */ 

LONG  ub_parm;  /»  parameter  for  drawing  function  */ 
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] USERBLK; 

typedef  struct  parm_blk 

OBJECT  *pb_tree; 

WORD  pb_ob j ; 

WORD  pb_prevstate; 

WORD  pb.currstate; 

WORD  pb_x,  pb_y,  pb_w,  pb_hj 
WORD  pb_xc,  pb_yc,  pb_wc,  pb_hc; 

LONG  pb_parm; 

] PARMBLK; 

Zur  Verdeutlichung  sehen  wir  uns  das  Beispiel  Checkbox  an.  Die  Chekbox  wird  im  RCS 
als  Objekt  vom  Typ  G_BOX  eingetragen.  Damit  das  AES  aber  erkennt,  dafi  nicht  die 
normale  Box,  sondern  der  neue  Typ  gezeichnet  werden  soli,  mufi  man  den  Objekttyp  zur 
Laufzeit  andern.  Dazu  legen  wir  uns  fiir  jeden  neuen  Objekttyp  eine  Variable  vom  Typ 
USERBLK  an. 

LOCAL  USERBLK  check_blk; 

Bei  alien  Objekten  vom  erweiterten  Typ  DCHECKBOX  wird  nach  dem  Laden  der 
Resource-Datei  folgendes  gemacht:  Zunachst  wird  die  Zeichenfunktion  (die  Adresse  der 
Funktion),  die  das  neue  Objekt  darstellen  soil,  in  das  Feld  ub_code  eingetragen.  In  un- 
serem  Fall  heilJt  die  Funktion  draw_checkbox. 

check_blk.ub_code  = draw_checkbox; 

Sei  „ob“  ein  Zeiger  auf  das  zu  iindernde  Objekt  mit  Namen  SBESTFIT  (aus  dem  RCS), 
also 


ob  = &dialog  [SBESTFIT]; 

Dann  miissen  wir  noch  folgende  Aktionen  vornehmen:  In  das  Feld  ub_parm  wird  der 
aktuelle  Wert  des  ob_spec  eingetragen,  damit  dieser  nicht  verloren  geht.  AnschlieBend 
wird  der  Typ  unseres  neuen  Objekts  auf  G_USERDEF  gesetzt.  SchlieBlich  mussen  wir 
dem  AES  noch  mitteilen,  wie  es  die  neue  Zeichenfunktion  finden  soil.  Dazu  muB  der 
ob_spec-Wert  auf  die  USERBLK-Struktur  (in  unserem  Beispiel  check_.blk)  zeigen. 

check_blk.ub_parm  = ob->ob_spec; 

ob->ob_type  = G_USERDEF; 

ob->ob_spec  = (LONG)&check_blk; 

Jetzt  sind  wir  im  Prinzip  fertig,  wenn  die  neue  Zeichenfunktion  erstellt  ist.  Die  neue  Zei- 
chenfunktion wird  vom  AES  angesprungen,  wenn  das  Objekt  gezeichnet  oder  geandert 
werden  soli  (z.B.  anderer  Objektstatus).  Die  Zeichenfunktion  (z.B.  draw  checkbox) 
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wird  vom  AES  mil  einem  einzigen  Parameter  versorgt,  einem  Zeiger  auf  die  PARMBLK- 
Struktur  (siehe  AES.H).  Mit  Hilfe  dieser  Struktur  erhalt  die  Zeichenfiinktion  alle  notwen- 
digen  Informationen  iiber  das  Objekt,  wie  die  Objektnummer,  den  Baum,  an  dem  das  Ob- 
jekt  hangt,  den  Status  des  Objekts,  die  Bildschirmkoordinaten  usw.  Die  nachfolgende 
Zeichenfunktion  draw_checkbox  zeigt,  wie  man  eigene  erweiterte  Objekte  in  Dialog- 
boxen  zeichnet.  Achtung!  In  der  Zeichenfunktion  diirfen  keinerlei  AES-Aufrufe  getatigt 
werden! 

#lf  MSDOS 

LOCAL  WORD  CDECL  draw_checkbox  () 

( 

PARMBLK  *pb; 

#else 

LOCAL  WORD  CDECL  draw_checkbox  (pb) 

PARMBLK  »pb; 

[ #endlf 

LONG  ob_spec ; 

WORD  ob_x,  ob_y,  ob_width,  ob_helght; 

^ BOOLEAN  selected,  changed; 

' WORD  pxy  [10] ; 

#if  MSDOS 

pb  = f ardr_start  ( ) ; 

#endif 

ob_spec  = pb->pb_parm; 

ob_x  = pb->pb_x; 

ob_y  = pb->pb_y; 

ob.width  = pb->pb_w; 

ob.height  = pb->pb_h; 

selected  = pb->pb_currstate  & SELECTED; 

changed  = (pb->pb_currstate  pb->pb_prevstate)  8e  SELECTED; 

set_clip  (pb->pb_x,  pb->pb_y,  pb->pb_w,  pb->pb_h) ; 

vsl_type  (vdi_handle,  FIS_S0LID); 
vsl.ends  (vdl_handle,  SQUARED,  SQUARED); 
vsl_width  (vdl_handle,  1); 
vsl_color  (vdi_handle,  obinfo.bdc); 
vswr_mode  (vdi.handle,  MD_REPLACE) ; 

if  (!  changed)  /*  war  eln  ob j c_draw-Auf ruf  */ 

[ 
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pxy  [0] 
pxy  [1] 
pxy  [2] 
pxy  [3] 
pxy  [4] 
pxy  [5] 
pxy  [6] 
pxy  [7] 
pxy  [8] 
pxy  [9] 


ob_x; 

ob_y; 

ob_x  + ob_width  — 1; 


ob_y; 

pxy  [2]; 

ob_y  + ob_height  — 1; 

ob_x; 

pxy  [5]; 

ob_x; 

oP-yj  /*  Rahmen  der  Box  zeichnen  */ 


v_pline  (vdi_handle,  5,  pxy); 
j /»  if  »/ 


if  (selected)  /*  war  ob j c_change-Auf ruf  */ 
vsl_color  (vdi_handle,  BLACK); 
else 

vsl.color  (vdi_handle,  WHITE); 


set_clip  (ob_x  + 1,  ob_y  + 1,  ob_width  - 2,  ob_height  - 2); 


pxy  [0]  = ob_x; 
pxy  [1]  = ob_y; 

pxy  [2]  = ob_x  + ob_width  - 1; 
pxy  [3]  = ob_y  + ob_height  - 1; 
v_pline  (vdl_handle,  2,  pxy) ; 

pxy  [0]  = ob_x  + ob_width  - 1; 
pxy  [1]  = ob_y; 
pxy  [2]  = ob_x; 

pxy  [3]  = ob_y  + ob_height  - 1; 
v_pline  (vdi_handle,  2,  pxy); 

#if  MSDOS 
f ardr_end  ( ) ; 

#endif 

return  (pb->pb_currstate  & -SELECTED) ; 
) /*  draw_checkbox  */ 


Der  Anfang  der  Funktion  ist  vielleicht  fur  manchen  etwas  uniibersichtlich,  konnte  aber 
nicht  anders  gemacht  werden.  Der  Zeiger  auf  den  PARMBLK  wird  vom  AES  auf  dem 
ATARI  und  unter  X/GEM  auf  FLEXOS  korrekt  auf  dem  Stack  ubergeben,  wie  dies  im 
AES-Handbuch  in  Kapitel  6.8  angegeben  ist.  Unter  MS-DOS  wird  der  Zeiger  in  Regi- 
stem  ubergeben.  Aus  diesem  Grund  miissen  die  Funktionen  fardr_start  und  fardr_end 
am  Anfang  und  am  Ende  der  Zeichenfunktion  aufgerufen  werden.  Das  Wort  CDECL 
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bedeutet  fur  den  Compiler,  daB  die  Parameter  auf  dem  Stack  iibergeben  werden  sollen. 
Fur  Turbo-C  auf  dem  ATARI  ST  ist  diese  Angabe  unerlafilich. 

Wichtig  zu  erwahnen  ist  auch  die  Variable  changed.  Ist  changed  FALSE,  so  wurde  das 
Objekt  (zum  erstenmal)  gezeichnet.  In  unserem  Beispiel  wird  der  Rand  der  Box  gezeich- 
net  (if  ! changed  ...).  AnschlieBend  wird  das  Innere  der  Box  (das  Kreuz)  entweder  in  der 
Hintergrundfarbe  Schwarz  oder  in  der  Farbe  WeiB  gezeichnet.  Im  ersten  Fall  ist  das  Ob- 
jekt selektiert,  im  zweiten  Fall  muB  das  Innere  mit  weiB  geldscht  werden. 

Als  Funktionswert  sollte  der  augenblickliche  Status  des  Objekts  zuruckgegeben  werden. 
Das  AES  unternimmt  dann  noch  einige  Aktionen  je  nach  Funktionswert.  Ist  der  Status 
z.B.  DISABLED,  so  wird  das  Objekt  grau  (nicht  anwahlbar)  angezeigt.  Alle  Stati  bis  auf 
SELECTED  konnen  zuruckgegeben  werden.  Wird  der  Status  SELECTED  zuriickgege- 
ben,  so  wird  das  gesamte  Objekt  auf  dem  Bildschirm  invertiert,  was  wir  bei  unserer 
Checkbox  nicht  haben  mochten.  Deshalb  blenden  wir  das  SELECTED-Bit  aus  dem  Funk- 
tionswert aus  (pb_currstate  & -SELECTED). 

Im  Beispielprogramm  SHOWGEM  werden  die  drei  neuen  Objekttypen  unterstutzt.  Dort 
sieht  man  auch  den  Zusammenhang  zwischen  der  Initialisierung  der  neuen  Objekte  und 
den  AES-Strukturen. 

Bei  der  Beschreibung  der  nachfolgenden  Funktionen  wird  davon  ausgegangen,  daB  ein 
Objektbaum  rait  dem  RCS  erstellt  wurde.  Der  Objektbaum  ist  als 

OBJECT  +tree; 

definiert.  Die  Variable  tree  ist  also  ein  Zeiger  auf  einzelne  Objekte  (bzw.  ein  Feld  von 
Objekten,  was  in  der  Sprache  C semantisch  das  Gleiche  ist).  In  Pascal  wurde  man 

OBJECT  tree  [NUM_OBJ]; 

schreiben,  wenn  man  die  Anzahl  der  Objekte  vorher  wuflte. 


- OBJC  ADD 

- OBJC_DELETE 

Diese  beiden  Funktionen  wurden  in  anderen  Biichem  nie  genau  beschrieben.  Es  ist  auch 
verstandlich,  da  man  das  Aufbauen  von  Objektbaumen  interaktiv  mit  Hilfe  des  RCS  vor- 
nehmen  kann.  Nur  so  viel  sei  gesagt;  Mochte  man  selbst  Objektbaume  aufbauen,  so  muB 
man  den  Platz  fiir  die  Objekte  bereits  reserviert  haben,  das  Feld  mit  den  Objekten  liegt 
also  bereits  vor.  Mit  Hilfe  von  objc_add  kann  dann  eine  neue  Hierarchic  (Vater-Sohn- 
Beziehung)  bestimmt  werden. 

Mit  Hilfe  von  objc_delete  kann  ein  Objekt  aus  einem  bestehenden  Objektbaum  gelbscht 
werden.  Dabei  wird  lediglich  das  zu  loschende  Objekt  aus  dem  Baum  abgehangt,  es  bleibt 
quasi  als  Leiche  im  Feld  tree  stehen. 
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- OBJC_DRAW 

Diese  Funktion  wird  sehr  haufig  verwendet.  Damit  kann  ein  einzelnes  Objekt  oder  ein 
ganzer  Objektbaum  gezeichnet  werden.  Die  Tiefe  der  Hierarchie  kann  ebenfalls  angege- 
ben  werden.  Meist  wird  bis  zur  Hierarchie  8 gezeichnet,  da  es  keine  Objektbaume  gibt, 
die  mehr  Stufen  haben.  Der  Bereich  auf  dem  Bildschirm  (Clipping-Rechteck)  wird  eben- 
falls angegeben.  Beispiel: 

objc_draw  (tree,  ROOT,  MAX_DEPTH,  xdial,  ydial,  wdial,  hdial); 


- OBJC_FIND 

Hiermit  kann  untersucht  werden,  ob  sich  ein  Objekt  unter  dem  Mauszeiger  befindet.  Man 
erhalt  die  Objektnummer.  Hat  man  z.B.  einen  eigenen  Desktop  (siehe  Beispielprogramm 
SCRAP),  so  kann  man  herausfmden,  ob  der  Benutzer  auf  ein  Piktogramm  geklickt  hat. 
Beispiel: 

obj  = objc_find  (desktop,  ROOT,  MAX_DEPTH,  x_mouse,  y_mouse); 


- OBJC  OFFSET 

Da  die  x-  und  y-Koordinaten  von  Objekten  in  Objektbaumen  (oder  Dialogboxen)  immer 
relativ  zum  Vaterobjekt  angegeben  sind,  kann  es  mitunter  schwierig  zu  bestimmen  sein, 
wo  genau  sich  ein  Objekt  auf  dem  Schirm  befindet.  Die  Funktion  objc  offset  berechnet 
zum  angegebenen  Objekt  die  absoluten  x-  und  y-Bildschirmkoordinaten.  Beispiel:  Be- 
rechnen  der  x-  und  y-Koordinate  des  Knopfes  CANCEL  im  Programm  SHOWGEM: 

WORD  X,  y; 

objc_offset  (dialog,  DCANCEL,  &x,  &y); 


- OBJC_ORDER 

Auch  diese  Funktion  wird  fast  nie  benutzt.  Mit  ihr  kann  man  die  Hierarchieordnung  von 
Objekten  in  einem  Baum  zur  Laufzeit  verandern.  Im  allgemeinen  behalten  Objektbaume 
ihre  Ordnung  wahrend  des  gesamten  Programmlaufs  bei. 


- OBJC„EDIT 

Diese  Funktion  wird  ebenfalls  nur  selten  benutzt.  Mit  ihr  konnen  Texte  eines  bestimmten 
Objekttyps  editiert  werden.  In  alien  uns  bekannten  Biichern,  auBer  „Softwareentwicklung 
auf  dem  ATARI  ST“  ist  der  Objekttyp  falsch  angegeben.  Sogar  in  den  Original- 
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GEM-Unterlagen  von  Digital  Research.  Doit  steht,  daB  das  Objekt  vom  Typ  G_TEXT 
Oder  G_BOXTEXT  sein  muB.  In  Wahrheit  konnen  aber  nur  Objekte  vom  Typ 
G_FTEXT  und  G_FBOXTEXT  editiert  werden. 

Normalerweise  benutzt  man  die  Funktion  form_do,  um  die  komplette  Abhandlung  einer 
Dialogbox  durch  das  AES  vornehmen  zu  lassen.  Die  Felder,  in  die  Texte  eingetragen 
werden  konnen,  werden  vom  AES  gehandhabt.  Nur  wenn  man  seine  eigene  form_do- 
Routine  schreiben  mochte,  benotigt  man  die  objc„edit-Funktion. 


- OBJC  CHANGE 

Mit  Hilfe  der  Funktion  objc_change  kann  der  Status  (ob_state)  eines  Objekts  geandert 
und  das  Objekt  auf  Wunsch  neu  gezeichnet  werden.  Im  Beispielprogramm  SCRAP  wird 
diese  Funktion  bei  der  Verwaltung  des  eigenen  Desktop  benutzt.  Zieht  ein  Benutzer  ein 
Piktogramm  auf  ein  anderes,  so  wird  es  invertiert  dargestellt.  Der  Status  des  Objekts, 
auf  dem  der  Mauszeiger  sitzt,  mufi  also  auf  SELECTED  gesetzt  und  das  Objekt  neu  ge- 
zeichnet werden. 

Beispiel:  Der  Status  des  Druckerpiktogrammes  (das  SELECTED-Bit)  soil  invertiert  und 
das  Objekt  neu  gezeichnet  werden. 

objc_change  (desktop,  IPRINTER,  0,  desk.x,  desk,y,  desk.w,  desk.h, 
desktop  [IPRINTER]. oh_state  SELECTED,  TRUE); 

5.  FORM-LIBRARY 


50 

— form  do 

Dialogbox  abhandeln 

51 

— form_dial 

Bildschirmbereiche  reservieren 

52 

— form_alert 

Alert-Box  anzeigen 

53 

- form_error 

DOS-Fehlermeldung  anzeigen 

54 

— form_center 

Dialogbox  zentrieren 

55 

— form_button 

Mausknopf-Eingaben  abhandeln 

56 

— form_keybd 

Tastatureingaben  abhandeln 

Ein  Formular  (form)  ist  ein  mit  dem  RCS  erzeugter  Objektbaum,  zu  dem  man  auch  haufig 
Dialogbox  sagt.  Um  die  Interaktion  von  Dialogboxen  mit  dem  Benutzer  zu  erleichtern, 
wird  die  Form-Library  vom  AES  zur  Verfugung  gestellt. 

Mit  Hilfe  eines  einzigen  Aufrufs  (form_do)  kann  man  den  gesamten  Dialog  mit  dem 
Benutzer  vom  AES  abhandeln  lassen.  Das  AES  speichert  dann  die  Zustande  der  Dialog- 
behandlung  im  Objektbaum  der  Dialogbox  ab.  Wahlt  der  Benutzer  z.B.  Kndpfe  an,  die 
dann  selektiert  sind,  so  wird  im  Status  des  Objekts  das  SELECTED-Bit  gesetzt.  Die  Ap- 
plikation  kann  diese  Informationen  nach  Abhandlung  des  Dialogs  aus  dem  Objektbaum 
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herauslesen,  um  entsprechend  zu  agieren.  Auch  Texte,  die  vom  Benutzer  in  Textfeldern 
editiert  werden  kdnnen,  kdnnen  nach  Abhandlung  des  Dialogs  ausgelesen  werden. 

Der  Vorteil  liegt  klar  auf  der  Hand.  Zum  einen  muB  sich  der  Programmierer  nicht  um 
das  Handling  der  Dialogboxen  kiimmem,  und  zum  anderen  ist  die  Bedienung  jeder  Dia- 
logbox  fUr  den  Benutzer  gleich  und  zwar  uber  jedes  GEM-Programm  hinweg.  Der  Benut- 
zer muB  also  nicht  umlernen,  wenn  er  eine  Dialogbox  von  GEMDRAW  oder  WORD- 
PLUS  ausfullen  muB. 

Eine  Alertbox  (form_alert)  ist  nichts  anderes  als  eine  kleine  Dialogbox,  in  denen  meist 
Fehlermeldungen  angezeigt  werden,  die  zu  einer  sofortigen  Handlung  zwingen  sollen. 


Floppy  fl;  antivortet  nicht. 
Bitte  Uberprlifen  und 
eine  Disk  einlegen. 


I HBBRUCH  1 j lUEITEB  1 


Abb.  2.19:  Eine  Beispielalertbox 


Eine  Alertbox  kann  bis  zu  3 Knopfe  und  5 Zeilen  Text  beinhalten.  Ein  Piktogramm  auf 
der  linken  Seite  der  Box  zeigt  die  Art  des  Fehlers  an  (Notiz,  Warten,  Stop).  Alert-Boxen 
kdnnen  durch  eine  Zeichenkette  beschrieben  werden,  die  folgenden  Aufbau  besitzen  muB: 
[Piktogramm-Nummer]  [Text]  [Knopfe] 


Die  Piktogrammnummer  gibt  an,  welche  Art  Piktogramm  erscheinen  soil.  Dabei  gilt; 

0 = kein  Piktogramm 

1 = Notiz-Piktogramm  (Hinweis  auf  mdgliche  Fehler) 

2 = Warte-Piktogramm  (meist  um  eine  Aktion  zu  wiederholen) 

3 = Stop-Piktogramm  (fatale  Fehler,  wie  z.B.  Diskette  defekt) 

Der  Text  hat  folgenden  Aufbau: 

Textzeile  1 iTextzeile  21  usw. 

Die  einzelnen  Textzeilen  werden  also  mit  dem  Pipe-Symbol  ’ I ’ (logisches  „oder“  in  C) 
getrennt.  Das  gleiche  Format  gilt  auch  fur  die  Knopfe. 


Text  von  Knopf  1 1 Text  von  Knopf  2 1 Text  von  Knopf  3 
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Der  gesamte  Text  aus  Abbildung  2.19  mufi  dann  wie  folgt  aufgebaut  sein: 

BYTE  *alert_text; 

alert_text  = ”[2][Laufwerk  A:  antwortet  nicht.  IBitte  Laufwerk  uberpriifen 
Oder  I Diskette  einlegen][ABBRUCH  WHITER]”); 

Error-Boxen  (form_error)  sind  spezielle  Alert-Boxen,  die  nur  Betriebssystemfehler  an- 
zeigen.  Der  Text  wird  von  der  Form-Library  erzeugt.  Man  ubergibt  lediglich  die  Fehler- 
nummer  des  Betriebssystems. 


- FORM_DO 

Wie  oben  erwahnt,  wird  durch  form_do  die  gesamte  Interaktion  einer  Dialogbox  mit 
dem  Benutzer  abgehandelt.  Man  ubergibt  den  Objektbaum  und  das  erste  Objekt,  das  edi- 
tiert  werden  soil  (auf  das  sich  der  Cursor  stellen  soil).  Gibt  es  keine  editierbaren  Text- 
felder,  so  muB  eine  0 iibergeben  werden.  Man  bekommt  die  Objektnummer  zuriickgelie- 
fert,  mit  der  der  Benutzer  das  Formular  verlassen  hat. 

Achtung!  Wird  ein  Objekt,  bei  dem  das  TOUCHEXIT-Flag  gesetzt  ist,  mit  einem  Dop- 
pelklick  verlassen,  so  ist  bei  der  zuriickgelieferten  Objektnummer  das  hochste  Bit  gesetzt. 
Wird  kein  Doppelklick  benbtigt,  sollte  man  dieses  Bit  ausblenden. 

Beispiel: 

exit_obj  = form_do  (dialog,  O)  & 0x7FFF; 
if  (exit_obj  ==  DOK)  /*  Benutzer  hat  OK  gedriickt  */ 

[ 

usw, 

j /*  if  */ 


— FORM_DIAL 

Hiermit  konnen  bis  zu  vier  Aktionen  durchgefiihrt  werden: 

— Bildschirmbereich  als  belegt  kennzeichnen 

— Zeichnen  eines  sich  ausdehnenden  Rechtecks 

— Zeichnen  eines  schrumpfenden  Rechtecks 

— Bildschirmbereich  wieder  freigeben 

Die  beiden  mittleren  Optionen  sind  nur  noch  bei  GEM  l.X  giiltig  und  haben  ab  GEM 
2.x  keine  Bedeutung  mehr. 

Soil  eine  Dialogbox  auf  den  Bildschirm  gezeichnet  werden,  so  muB  die  Applikation  dem 
AES  mitteilen,  welchen  Bereich  des  Bildschirms  die  Dialogbox  benotigt.  Dies  wird  mit 
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dem  Aufruf  form_dial  und  der  Konstanten  FMD_START  erledigt.  AuBerdem  ubergibt 
man  den  Bildschirmbereich  der  Dialogbox. 

Wird  der  Dialog  beendet,  muB  das  AES  aus  dem  angegebenen  Bereich  Meldungen  an 
die  verschiedenen  Applikationen  senden  (WM_REDRAW),  damit  diese  den  Inhalt  ihrer 
Fenster  neu  zeichnen  konnen.  Nach  Beendigung  des  Dialoges  wird  dies  mit  form_dial 
und  der  Konstanten  FMD_FINISH  erledigt. 

Im  GEM  l.X  konnen  auBerdem  die  Konstanten  FMD  GROW  und  FMD  SHRINK  be- 
nutzt  werden,  wenn  sich  ausdehnende  oder  schrumpfende  Rechtecke  gezeichnet  werden 
sollen. 


- FORM_ALERT 

Zeigt  eine  Alertbox  an.  Man  Ubergibt  den  Default-Knopf,  den  der  Benutzer  mit  der 
Return-Taste  auswahlen  kann  und  erhalt  den  Knopf,  den  der  Benutzer  gedruckt  hat. 

Beispiel  mit  alert_text  von  oben,  wobei  der  Knopf  „ABBRUCH“  Nummer  1 ist: 

WORD  button; 
button  = form_alert 
if  (button  ==  1)  /* 

] /*  if  */ 


- FORM  ERROR 

Mdchte  man  Fehler  des  Betriebssystems  anzeigen  wie  etwa  „Datei  nicht  gefunden"  etc., 
so  kann  man  form_error  benutzen.  Man  ubergibt  die  Nummer  des  Betriebssystem- 
Fehlers  und  erhalt  den  Knopf,  der  gedruckt  wurde. 


(2,  alert_text) ; 
ABBRUCH  gewahlt  */ 


- FORM_CENTER 

Mit  der  Funktion  form_center  werden  die  Bildschirmkoordinaten  der  Wurzel  eines  Ob- 
jektbaumes  so  modifiziert,  daB  der  Objektbaum  (die  Dialogbox)  in  der  Mitte  des  Bild- 
schirms  erscheint.  Eine  Anwendung  kann  man  aus  der  Funktion  hndLdial  im  Pro- 
gramm  SHOWGEM  sehen. 

Ab  GEM/3  wird  eine  Dialogbox  in  y-Richtung  nicht  mehr  auf  dem  ganzen  Bildschirm 
zentriert.  Das  liegt  im  Aufkommen  der  GroBbildschirme  begrundet.  Wurde  eine  kleine 
Dialogbox  immer  in  der  Mitte  des  Bildschirms  erscheinen,  so  muBte  der  Benutzer  mit 
der  Maus  einen  erheblichen  Weg  zurucklegen,  bis  er  von  der  Menuleiste  zur  Dialogbox 
gefahren  ist. 
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- FORM_BUTTON 

- FORM_KEYBD 

Diese  beiden  Funktionen  werden  intern  von  der  form_do-Routine  benutzt,  um  Tastatur- 
und  Mausaktionen  beim  Bearbeiten  einer  Dialogbox  abzuhandeln.  Sie  werden  hochstens 
benutzt,  um  eigene  form_do-Routinen  zu  schreiben. 


6.  GRAPHICS-LIBRARY 


70 

— graf  rubbox 

Zieht  ein  Gummiband 

71 

— graf_dragbox 

Box  mit  Maus  verschieben 

72 

— graf_mbox 

Zeichnet  eine  sich  bewegende  Box 

73 

— graf  growbox 

Zeichnet  ein  sich  ausdehnendes  Rechteck 

74 

— graf  shrinkbox 

Zeichnet  ein  schrumpfendes  Rechteck 

75 

— graf_watchbox 

Uberwacht  eine  Box 

76 

- graf_slidebox 

Schieber  zeichnen 

77 

— graf_handle 

VDI-Handle  der  Arbeitsstation  holen 

78 

- graf_mouse 

Mausform  andern 

79 

— graf_mkstate 

Maus-/Tastaturinfo  holen 

Wenn  man  den  GEM-Desktop  zum  Kopieren  von  Dateien  benutzt,  so  kann  man  ein  Gum- 
miband  aufziehen,  um  mehrere  Dateien  einzurahmen.  Man  wind  es  auch  des  bfteren  in 
einer  Applikation  damit  zu  tun  haben,  rechteckige  Rahmen  zu  manipulieren.  Auch  die 
Abfrage  der  Mausposition,  die  ja  nicht  mit  VDI-Befehlen  durchgefiihrt  werden  kann, 
wird  mit  Funktionen  aus  der  Graphics-Library  realisiert. 


- GRAF  RUBBOX 

In  vielen  Bindings  verschiedener.  C-Compiler  auf  dem  ATARI  ST  ist  der  Name  der  Funk- 
tion  falsch  angegeben.  Dort  erscheint  dann  graf_rubberbox.  Diese  Funktion  existiert 
aber  nicht,  sie  wird  von  Digital  Research  in  den  Original-GEM-Bindings  mit 
graf_rubbox  angegeben.  Sie  konnen  auf  jeden  Fall  den  Originalnamen  benutzen,  wenn 
Sie  die  Datei  PORTAB.H  inkludieren.  Sie  merzt  solche  Fehler  aus. 

Mit  Hilfe  dieser  Funktion  kann  mit  der  Maus  ein  Gummiband  aufgezogen  werden.  Inter- 
essant  ist,  daB  bei  Angabe  der  minimalen  Breite  und  Hohe  auch  negative  Werte  zugelas- 
sen  sind.  Das  Gummiband  laBt  sich  dann  auch  von  rechts  unten  nach  links  oben  ziehen. 


- GRAF„DRAGBOX 

Hiermit  kann  eine  quadratische  Box  innerhalb  eines  angegebenen  Rechtecks  verschoben 
werden.  Man  iibergibt  die  Position,  Breite  und  Hdhe  der  Box,  sowie  den  Bereich,  in  dem 
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die  Box  verschoben  werden  kann.  Das  AES  ubernimmt  dann  beim  Driicken  der  Maustaste 
automatisch  das  Verschieben  der  Box  und  kehrt  erst  dann  zuriick,  wenn  der  Benutzer  den 
Mausknopf  wieder  losgelassen  hat.  Die  Position  der  verschobenen  Box  wird  zuriick- 
gegeben. 


- GRAF_MBOX 

Auch  hier  ist  der  Name  in  vielen  Bindings  mit  graf_movebox  angegeben.  Der  Original- 
name  ist  aber  graf_mbox,  der  mit  Hilfe  von  PORTAB.H  immer  benutzt  werden  kann 
(graf_movebox  und  graf_mouse  sind  in  den  ersten  7 Buchstaben  identisch).  Eine  sich 
bewegende  Box  von  einer  Position  zu  einer  anderen  wird  gezeichnet.  Man  wird  dies  dort 
benutzen,  wo  das  Verschieben  eines  Piktogrammes  nicht  erlaubt  ist  und  es  an  seine  ur- 
spriingliche  Stelle  zuriickpositioniert  wird  (z.B.  Drucker  auf  Papierkorb  legen). 


- GRAF_GROWBOX 

- GRAF_SHRINKBOX 

Diese  beiden  Funktionen  werden  ab  GEM  2.X  nicht  mehr  unterstiitzt.  Sie  dienen  dazu, 
sich  vergroBernde  und  verkleinernde  Rechtecke  zu  zeichnen.  Man  benutzt  sie  z.B.,  wenn 
sich  ein  Fenster  aus  dem  Offnen  eines  Piktogrammes  ergibt,  damit  der  Benutzer  weiB, 
von  welchem  Objekt  aus  das  Fenster  geoffnet  wurde.  Auf  dem  Macintosh  werden  diese 
Boxen  immer  benutzt. 

Um  sie  dennoch  zu  zeichnen,  existiert  die  Extended-Graphics- Library.  Wie  man  mit  ihr 
die  fehlenden  Boxen  auch  ab  GEM  2.X  wieder  herbeizaubern  kann,  wird  im  Beispielpro- 
gramm  SCRAP  gezeigt. 


- GRAF_WATCHBOX 

Diese  Funktion  wird  von  einer  Applikation  eigentlich  nie  benutzt.  Die  FORM-Library 
benotigt  sie,  wenn  man  mit  der  Mans  in  einer  Dialogbox  auf  ein  Exit-Objekt  klickt  und 
die  Maustaste  noch  gedriickt  halt.  In  diesem  Falle  kann  der  Status  eines  Objektes  (z.B. 
der  OK-Knopf)  invertiert  werden,  werm  der  Benutzer  mit  gedriickter  Maustaste  in  die 
Box  fahrt  und  sie  wieder  verl^t. 


- GRAF_SLIDEBOX 

Mit  der  Funktion  graf_slidebox  kann  ein  horizontaler  Oder  vertikaler  Schieber  erzeugt 
werden.  Die  WINDOWS-Library  benutzt  diesen  Aufruf  fur  die  horizontalen  bzw.  verti- 
kalen  Schieber.  Auch  die  FILE-SELECTOR-LIBRARY  benutzt  diesen  Aufruf,  wenn  in 
der  Dateiauswahlbox  so  viele  Dateien  angezeigt  werden,  daB  man  scrollen  kann. 
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- GRAF_HANDLE 

Wie  schon  in  Kapitel  2.3  erklart,  offnet  das  AES  den  Bildschirm  als  physikalische  VDI- 
Arbeitsstation.  Da  unsere  Applikation  den  Bildschirm  auch  benotigt  und  wir  diesen  nur 
noch  virtuell  offnen  diirfen,  benotigen  wir  die  physikalische  Kennung  (handle)  des  Bild- 
schirms  bei  der  Funktion  v_opnvwk.  Diese  Kennung  erhalten  wir  mit  der  Funktion 
graf  handle. 

Aufler  der  VDI-Kennung  bekommen  wir  noch  4 weitere  GrbUen  zuriickgeliefert,  die 
enorm  wichtig  sind.  Die  ersten  beiden  geben  die  Breite  und  Hbhe  einer  Zeichenzelle  im 
Systemzeichensatz  an.  Der  Systemzeichensatz  wird  in  Menus  und  Dialogboxen  benutzt. 
Die  beiden  letzten  GroBen  geben  die  Breite  und  Hbhe  einer  Box  an,  die  bei  Fensterattribu- 
ten  benutzt  werden.  Fensterattribute  sind  z.B.  die  Pfeile,  SchlieBbox,  VergrbBerungsbox 
usw. 

Beispiel: 

WORD  phys_handle; 

WORD  gl_wbox,  gLhbox,  gl_wattr,  gl_hattr; 

phys_handle  = graf_handle  (&gl_wbox,  &gl_hbox,  &gl_wattr,  &gl_hattr); 


- GRAF_MOUSE 

Mit  dieser  Funktion  kann  das  Aussehen  der  Maus  verandert  werden.  Die  Mausform  kann 
von  einem  Pfeil  z.B.  zu  einer  Sanduhr  (MS-DOS)  oder  einer  Biene  (ATARI  ST)  geandert 
werden,  um  anzuzeigen,  daB  der  Rechner  gerade  arbeitet.  Auch  selbstdefinierte  Mausfor- 
men  kbnnen  erstellt  werden.  Im  Beispielprogramm  SCRAP  wird  davon  Gebrauch 
gemacht. 


- GRAF  MKSTATE 

Da  bei  AES-Applikationen  keine  VDI-Eingabefiinktionen  aufgerufen  werden  durfen,  um 
z.B.  die  Maus  und  Tastatur  abzufragen,  bietet  das  AES  die  Funktion  graf_mkstate 
(Maus-Keyboard-Status)  an.  Dabei  werden  die  Mauskoordinaten,  die  Mausknopfe,  die 
linke  und  rechte  Shift-Taste  und  die  Control-  und  Alternate-Taste  zuriickgeliefert.  Ein 
Bit  sagt  jeweils  aus,  ob  die  Taste  gedriickt  (1)  oder  losgelassen  ist  (0). 

7.  SCRAP-LIBRARY 


80  - scrp_read  Klemmbrett-Directory  lesen 

81  — scrp_write  Klemmbrett-Directory  schreiben 

82  — scrp_clear  Klemmbrett-Directory  loschen 
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Wer  schon  einmal  mil  einem  Macintosh  gearbeitet  hat,  der  weifi,  dafi  es  mbglich  ist,  Da- 
ten  zwischen  beliebigen  Applikationen  auszutauschen.  So  kann  man  eine  Zeichnung  mit 
MacPaint  erstellen  und  sie  anschlicBend  z.B.  in  einem  Desktop-Publishing-Programm 
einbinden.  Dasselbe  gilt  auch  fiir  objektorientierte  Vektorzeichnungen  mit  MacDraw. 

Auf  dem  ATARI  ST  z.B.  ist  es  bisher  kaum  moglich,  Daten  aus  verschiedenen  GEM- 
Applikationen  auszutauschen.  Digital  Research  hatte  aber  schon  immer  im  GEM  diese 
Moglichkeiten  vorgesehen.  Bisher  sind  sie  nur  noch  nicht  beschrieben  bzw.  benutzt 
worden. 

Um  Daten  von  einer  Applikation  zu  einer  anderen  Applikation  auszutauschen,  soil  es  fol- 
gende  Funktionen  geben:  Eine  Zwischenablage  (Klemmbrett,  Clipboard)  soil  die  Daten, 
sogenannte  Scraps,  aufnehmen  konnen.  Daten  konnen  von  einer  Applikation  aus  entwe- 
der  ausgeschnitten  (Cut),  kopiert  (Copy)  oder  eingefugt  (Paste)  werden. 

Beim  Ausschneiden  werden  die  selektierten  Daten  aus  der  laufenden  Applikation  geloscht 
und  in  das  Systemklemmbrett  kopiert.  Beim  Kopieren  bleiben  die  Daten  in  der  laufenden 
Applikation  erhalten  und  werden  auf  das  Klenunbrett  kopiert.  Beim  Einfiigen  schlieBlich 
werden  die  Daten  aus  dem  Systemklemmbrett  entnommen  und  in  die  neue  Applikation 
hineinkopiert. 

Das  Systemklemmbrett  ist  ein  Verzeichnis  (Ordner,  Subdirectory)  auf  einer  Diskette 
Oder  Festplatte.  In  alteren  GEM-Versionen  (bis  GEM  2.X)  hiel)  dieses  Verzeichnis 
GEMSCRAP.  Ab  GEM  3.X  heiBt  es  CLIPBRD  und  befindet  sich  im  Verzeichnis 
GEMAPPS. 

Fiir  den  ATARI  ST  gibt  es  zur  Zeit  genau  ein  einziges  Programm,  das  die  Zwischenab- 
lage konsequent  nutzt:  Die  neueste  Version  von  WORDPLUS.  Dazu  legt  es  sich  im  Wur- 
zelverzeichnis  den  Ordner  CLIPBRD  an,  wenn  er  noch  nicht  existiert.  Wir  vereinbaren 
an  dieser  Stelle  also:  Das  Verzeichnis  fiir  die  Zwischenablage  auf  dem  ATARI  ST  heiBt 
CLIPBRD  und  befindet  sich  im  Wurzel verzeichnis  der  Diskette  oder  der  Festplatte.  Jedes 
Programm,  das  in  Zukunft  diese  Zwischenablage  nutzt,  hat  diesen  Ordner  bei  Nichtvor- 
handensein  anzulegen  oder  ihn  zu  benutzen,  wenn  er  schon  da  ist.  Das  Programm  SCRAP 
iibernimmt  die  Verwaltung  dieses  Systemklemmbrettes  und  wird  in  Kapitel  6 genauestens 
erlautert. 

Fiir  MS-DOS  gilt  ab  GEM  Version  3.X,  dal)  sich  das  Systemklemmbrett  ira  Ordner 
\GEMAPPS\CLIPBRD  befindet. 

Um  verschiedenartige  Daten  auszutauschen,  unterstiitzt  das  AES  folgende  Dateitypen: 

a)  CSV  = Comma  separated  values 

b)  TXT  = ASCII-Dateien 

c)  DIF  = Daten  von  Tabellenkalkulationen 

d)  GEM  = Metadateien 

e)  IMG  = Bit-Image-Dateien 

f)  DCA  = IBM  document  contents  architecture 

g)  USR  = benutzerdefmiertes  Format 
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Alle  Dateien  beginnen  mit  dem  Dateinamen  SCRAP  und  haben  einen  der  o.g.  Suffixe. 
Eine  Metadatei  erscheint  also  als  SCRAP. GEM,  wenn  diese  aus  einem  Zeichenprogramm 
ins  Systemklemmbrett  geschrieben  wird.  Aus  dieser  Forderung  ergibt  sich,  dafi  das 
Klemmbrett  nur  eine  Stufe  tief  ist.  Kopiert  man  also  zwei  GEM-Dateien  hinein,  so  wird 
die  erste  Datei  automatisch  iiberschrieben. 

Urn  Daten  verschiedenen  Programmen  zuganglich  zu  machen,  darf  man  die  ausgeschnit- 
tenen  oder  kopierten  Daten  auch  in  verschiedenen  Formaten  abspeichern.  Ein 
WORDPLUS-Textstuck  konnte  als  SCRAP.TXT  und  als  SCRAP. IWP  im  Verzeichnis 
CLIPBRD  erscheinen.  Ersteres  ist  das  Textstuck  als  reine  ASCII-Datei,  zweites  ist  das 
gleiche  Textstuck  mit  den  Formatanweisungen  fiir  WORDPLUS.  So  kann  wenigstens  die 
Textdatei  in  andere  Programme  ubernommen  werden,  wahrend  die  IWP-Datei  in  die 
Programme  ubernommen  werden  kann,  die  das  Format  von  WORDPLUS  verstehen. 

Weitere  Informationen  zum  Systemklemmbrett  befinden  sich  in  Kapitel  6,  wo  die  Arbeits- 
weise  genau  beschrieben  wird. 


- SCRP_READ 


Mit  dieser  Funktion  kann  man  den  Pfad  lesen,  wo  sich  das  Systemklemmbrett  befindet. 
AuBerdem  bekommt  man  einen  Bitvektor  zuriick,  der  das  Vorhandensein  der  Dateien 
„SCRAP.*“  priift.  Ist  kein  Systemklemmbrett  vorhanden,  erh^t  man  den  Wert  — 1.  Fiir 
andere  Werte  gelten  folgende  Bitbelegungen: 


Bit  0:  SCRAP.CSV 
Bit  1:  SCRAP.TXT 
Bit  2:  SCRAP.GEM 
Bit  3:  SCRAP.  IMG 
Bit  4:  SCRAP.  DC  A 
Bit  15:  SCRAP.USR 

Alle  anderen  Bits  sind  fiir  zukiinftige  Versionen  reserviert. 


Leider  funktioniert  scrp_read  auf  dem  ATARI  ST  noch  nicht.  Zu  diesem  Zweck  kann 
die  Funktion  scrap_read  im  Modul  CLIPBRD  des  Programmes  SCRAP  aufgerufen 
werden. 


- SCRP_WRITE 

Hiermit  wird  das  Systemklemmbrett  eingerichtet,  wenn  es  noch  nicht  vorhanden  ist.  Jede 
Applikation  konnte  sich  also  ein  eigenes  Klemmbrett  einrichten.  Wir  raten  dringend 
davon  ab,  da  sonst  das  Chaos  nicht  mehr  iiberschaubar  ware.  Deshalb  soil  nur  der  o.g. 
Standardname  eingetragen  werden  (fiir  MSDOS:  \GEMAPPS\CLIPBRD  und  fiir 
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ATARI  ST:  \CLIPBRD).  Diese  Funktion  ist  auf  dem  ATARI  ST  korrekt  implementiert 
und  kann  direkt  aufgerufen  werden. 


- SCRP_CLEAR 

Alle  Dateien  mit  dem  Namen  SCRAP  und  beliebigem  Suffix  werden  im  Klemmbrett- 
Verzeichnis  geldscht.  Leider  funktioniert  der  Aufruf  scrp_clear  auf  dem  ATARI  ST 
nicht.  Deshalb  verwenden  wir  die  Funktion  scrap_clear  aus  dem  Modul  CLIPBRD  des 
Programmes  SCRAP. 


8.  FILE-SELECTOR-LIBRARY 


90  — fsel_input  Dateiauswahlbox  benutzen 

91  - fsel_exinput  erweiterte  Dateiauswahlbox  benutzen 


- FSEL_INPUT 

Zu  dieser  Library  gibt  es  eigentlich  nicht  viel  zu  sagen.  Jeder  hat  die  Wirkung  des  Aufrufs 
fsel_input  schon  einmal  selbst  erlebt.  Es  erscheint  die  Dateiauswahlbox  (Item  selector, 
Objekt-Auswahl),  mit  der  der  Benutzer  eine  Datei  anwahlen  kann.  Startet  man  z.B. 
WORDPLUS,  so  erscheint  sofort  diese  Box,  um  den  Namen  der  Datei,  die  man  editieren 
mochte,  angeben  zu  konnen. 


1 OBJEKT  nUSUIRHL 

INDEH: 

C:MU0RDPLUS\*.» 



nUSUIRHL:  NRMENLOS.DOC 

LRIIFIUERK: 

I 

1 

liiil 

B 

D 

ES  DDES 

V 

E 

F 

ES  DRUCKER 

(> 

H 

ES  FORMATS 

1 

a 

ES  IMAGES 

K 

L 

ES  INSTALL 

M 

ES  MAIL  DAT 

H 

(i 

p 

1ST-MRIL.PRG 

11 

1ST_MRIL.BSC 

11 

rmn 

DEGflSNflP.PRG 

V 

1 RBBRUCH  1 1 

1 

=— 1 

Abb.  2.20:  Dateiauswahlbox  ATARI  ST  (TOS  1 .4) 
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Nach  dem  Aufruf  bekommt  man  den  Pfad  und  die  Datei  zuriick,  die  man  ausgew^lt  hat. 
Ebenfalls  wird  ein  Wert  zuriickgeliefert,  der  aussagt,  ob  ein  Benutzer  den  Knopf  OK  oder 
ABBRUCH  gewahlt  hat. 


- FSEL_EXINPUT 

Die  Funktion  fsel_exinput  ist  nur  auf  dem  ATARI  ST  ab  TOS  Version  1.4  verfiigbar. 
Die  erweiterte  Dateiauswahlbox  erlaubt  der  Applikation  noch  eine  Zeichenkette  mit  hoch- 
stens  30  Zeichen  zu  ubergeben,  die  dann  am  oberen  Rand  der  Box  angezeigt  wird. 

Beispiel:  Zeige  erweiterte  Dateiauswahlbox  mit  Meldung  „Text  einlesen“. 

BYTE  fs.ilnpath  [128]; 

BYTE  fs_iinsel  [12]; 

WORD  fs_iexbutton; 

BYTE  fs_ilabel  [31]; 

strcpy  (fs.linpath,  "C:\\W0RDPLUS\\*.D0C") ; 
strcpy  (fs_iinsel,  "NEU.DOC"); 
strcpy  (fs_llabel,  "Text  elnlesen"); 

fsel_exinput  (fs_llnpath,  fs_iinsel,  &fs_iexbutton,  fs_ilabel); 


9.  WINDOW-LIBRARY 


100 

— wind_create 

Fenster  kreieren 

101 

- wind_open 

Fenster  offhen 

102 

— wind_close 

Fenster  schlieBen 

103 

— wind_delete 

Fenster  loschen 

104 

— wind_get 

Fensterinformationen  holen 

105 

— wind_set 

Fensteraufbau  bestimmen 

106 

- wind_fmd 

Fenster  unter  Maus  bestinunen 

107 

- wind_update 

Fenster  restaurieren 

108 

— wind_calc 

FenstergroBen  holen 

109 

— wind_new 

Alle  Fenster  loschen 

In  einem  GEM-System  konnen  maximal  8 Fenster  benutzt  werden.  7 davon  sind  soge- 
nannte  Applikations-Fenster,  das  achte  ist  das  Desktop-Fenster. 

Das  Desktop-Fenster  besteht  aus  der  Menuleiste  und  dem  Bereich  unter  der  Menuleiste, 
dem  Arbeitsbereich.  Dieses  Fenster  ist  immer  vorhanden  und  kann  nicht  geloscht  werden. 
Die  meisten  GEM-Programme  benutzen  dieses  Fenster  als  Hintergrund  fur  ihre  Applika- 
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lion.  Es  wird  vom  AES  verwaltet  und  besitzt  die  Kennung  0.  In  der  Beispielapplikation 
SCRAP  wird  dieses  Fenster  mil  der  C-Konstanten  DESK  referiert  (#  define  DESK  0). 


Die  anderen  sieben  Fenster  werden  von  der  Applikation  benutzt,  um  irgendetwas  darin 
anzuzeigen  (Grafik,  Texte  usw.).  Ein  Fenster  (siehe  Abb.  2. 15)  besteht  aus  2 Bereichen: 
Den  Randbereichen  (border  area)  wie  Schliefibox,  Schieber,  Infozeile  und  dem  Arbeits- 
bereich  (work  area). 


Alle  Aktionen,  die  mit  den  Randbereichen  eines  Fensters  durchgefuhrt  werden,  werden 
vom  AES  automatisch  verwaltet.  Verschiebt  ein  Benutzer  ein  Fenster,  so  iiberwacht  das 
AES  die  Verschiebung  und  meldet  der  Applikation  die  neue  Fensterposition  iiber  Nach- 
richten,  in  diesem  Fall  WM_MOVED  (siehe  Event-Library).  Nachdem  eine  Meldung 
gesendet  wurde,  kann  die  Applikation  entscheiden,  ob  sie  die  Aktion  durchfuhren  moch- 
te.  In  unserem  Beispiel  kann  die  Applikation  verhindern,  daJ)  das  Fenster  vom  Benutzer 
verschoben  wird. 


MuB  ein  Fenster  neu  gezeichnet  werden,  so  sendet  das  AES  der  Applikation  die  Nachricht 
WM_REDRAW.  Die  Applikation  kann  sich  die  Teile  des  Fensters  holen,  die  neu  ge- 
zeichnet werden  miissen.  Das  AES  verwaltet  eine  sogenannte  Rechteckliste,  in  der  zu  je- 
dem  Fenster  das  Innere  des  Fensters  in  Rechtecke  unterteilt  wird.  Liegt  das  Fenster  oben, 
so  gibt  es  genau  ein  Rechteck,  namlich  das  gesamte  Fensterinnere.  Liegt  ein  Fenster  fiber 
einem  anderen  Fenster,  so  gibt  es  2,  3 oder  hochstens  4 Rechtecke,  die  neu  gezeichnet 
werden  mussen. 

Die  Fensterverwaltung  ist  im  Prinzip  in  jeder  Applikation  gleich.  Es  andert  sich  nur  die 
Funktion,  die  das  Fensterinnere  zeichnet  (z.B.  die  Funktion  wi_draw,  die  in  jedem  Mo- 
dul  existiert,  das  mit  Fenstern  zu  tun  hat).  Aus  diesem  Grund  wurde  der  Windowmanager 
im  Modul  WINDOWS  der  Beispielapplikation  SCRAP  entwickelt.  Er  handelt  fast  alle 
Fensteraktionen  automatisch  ab.  Man  mu6  ihm  nur  noch  die  Zeichenfunktion  und  einige 
andere  Funktionen  fibergeben.  Der  Manager  fiberwacht  die  AES-Fenstemachrichten  und 
ruft  die  entsprechende  Funktion  in  jedem  Modul  auf,  das  Fenster  verwaltet.  Die  AES- 
Fensterfunktionen  werden  also  ausschlieBlich  vom  Windowmanager  benutzt  und  werden 
deshalb  kurz  beschrieben,  falls  man  sich  in  fremde  GEM-Applikationen  einarbeiten  muB. 


- WIND_CREATE 


Durch  Aufruf  von  wind_create  wird  ein  neues  GEM-Fenster  erzeugt.  Man  kann  ange- 
ben,  welche  Randattribute  (SchlieBbox,  VergroBerungsbox,  Infozeile  usw.)  das  Fenster 
bekommen  kann  (siehe  AES.H).  AuBerdem  gibt  man  an,  welche  MaximalgroBe  das  Fen- 
ster Jemals  annehmen  kann.  Der  Funktionswert  ist  die  sogenannte  Fensterkennung  (win- 
dow handle).  Ist  diese  Kennung  groBer  oder  gleich  0,  so  konnte  das  Fenster  erzeugt  wer- 
den. Mit  dieser  Kennung  werden  dann  alle  weiteren  Funktionen  aus  der  Window-Library 
aufgerufen. 
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Ab  GEM  2.x  existiert  eine  neue  Randkomponente: 
# define  HOTCLOSE  0x1000 


Die  „Hotclosebox“  ist  nichts  anderes  als  eine  SchlieBbox,  bei  der  das  TOUCHEXIT-Flag 
gesetzt  ist.  Klickt  der  Benutzer  auf  solch  eine  SchlieBbox  und  l^t  den  Mausknopf  ge- 
driickt,  so  wird  vom  AES  standig  die  Meldung  WM_CLOSED  gesendet.  Der  GEM 
Desktop  ab  Version  2.X  benutzt  diese  Box,  wenn  man  ein  Fenster  schlieBen  mochte.  Ist 
man  z.B.  in  der  3.  Ebene  eines  Inhaltsverzeichnisses,  so  muB  man  nicht  3-mal  klicken, 
um  auf  die  oberste  Ebene  zu  gelangen.  Man  muB  nur  den  Mausknopf  auf  der  SchlieBbox 
gedriickt  halten. 


- WIND  OPEN 

Ruft  man  wind  open  auf,  so  erscheint  das  mit  wind_create  erzeugte  Fenster  auf  dem 
Bildschirm.  Die  Anfangsposition  und  -grdfle  wird  mitiibergeben. 

Beispiel:  Erzeugen  eines  Fensters  mit  MaximalgroBe  200x200  und  Offnen  des  Fensters 
mit  GroBe  100x100. 

WORD  wh; 

wh  = wind_create  (NAME+CLOSER,  0,  0,  200,  200); 
if  (wh  >=  0) 

[ : 

wind_open  (wh,  0,0,  100,  100); 

) /*  if  */ 


- WIND_CLOSE 

Das  Fenster  mit  der  angegebenen  Kennung  kann  durch  wind_close  geschlosssen  wer- 
den.  Das  Fenster  verschwindet  vom  Bildschirm.  Die  Kennung  wird  noch  nicht  freigege- 
ben,  womit  das  Fenster  jederzeit  wieder  mit  wind_open  geoffnet  werden  kann. 


- WIND_DELETE 

Das  Fenster  mit  der  angegebenen  Kennung  wird  komplett  geloscht  und  die  Kennung  wird 
freigegeben.  Erst  durch  wind_create  kann  wieder  ein  neues  Fenster  beschafft  werden. 
Der  Vorteil  von  wind_delete  ist,  daB  andere  Prozesse  (z.B.  Accessories)  die  freien  Ken- 
nungen  weiter  benutzen  konnen,  da  ja  nur  sieben  Fenster  erzeugt  werden  konnen. 
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- WIND_GET 

- WIND  SET 

Informationen  iiber  ein  Fenster  konnen  geholt  oder  gesetzt  werden.  Dazu  gehoren  die  au- 
genblickliche  GroBe  und  Position,  die  GroBe  und  Positionen  der  horizontalen  und  vertika- 
len  Schieber,  die  Rechteckliste,  der  Name  des  Fensters  usw.  Dabei  werden  verschiedene 
Konstanten  als  Informationsunterscheidung  ubergeben  (siehe  AES.H,  wind_get  flags), 
und  man  erhalt  entsprechend  4 Riickgabewerte  zu  16  Bit  (WORD). 


Beispiel:  Name  des  Fensters  setzen  und  Arbeitsbereich  (work  area)  des  Fensters  holen. 

WORD  X,  y,  w,  h; 

BYTE  *wind_name; 

wind_name  = ” Fenstername 

wind_set  (wh,  WF_NAME,  ADR  (wind_name),  0,  0); 
wind  get  (wh,  WF  WXYWH,  &x,  &y,  &w,  &h); 

Bemerkung:  Bei  der  Angabe  des  Fensternamens  sollte  man  aus  asthetischen  Griinden  vor 
und  hinter  der  Zeichenkette  immer  ein  Leerzeichen  lassen,  da  sonst  das  Muster  im  Fen- 
sternamen  direkt  am  ersten  und  am  letzten  Buchstaben  hangt. 


- WIND_FIND 


Mochte  man  zu  einer  gegebenen  Mausposition  wissen,  welches  Fenster  sich  unter  der 
Maus  befindet,  so  kann  man  wind_find  aufrufen.  Der  Funktionswert  ist  die  Fenster- 
kennung. 


- WIND_UPDATE 


Mit  der  Funktion  wind_update  konnen  2 Zustande  ein-  oder  ausgeschaltet  werden.  Soli 
das  Innere  eines  Fensters  neu  gezeichnet  werden,  so  muB  dies  dem  AES  mitgeteilt  wer- 
den, damit  es  die  Zeichenfunktion  der  Applikation  nicht  stort  (BEG_UPDATE, 
END_UPDATE). 

Der  andere  Zustand,  der  ein-  oder  ausgeschaltet  werden  kann,  laBt  die  Applikation  die 
gesamte  Mauskontrolle  iibernehmen  (BEG_MCTRL,  END_MCTRL).  Der  Bild- 
schirmmanager  klinkt  sich  aus  und  die  Applikation  muB  auf  alle  Mausereignisse  selbst 
reagieren.  Drop-Down-Meniis  oder  Randbereiche  von  Fenstern  werden  vom  AES  dann 
nicht  mehr  verwaltet.  Dies  ist  nur  dann  sinnvoll,  wenn  das  GEM-System  die  Applikation 
zu  sehr  einschrankt. 
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Beispiel:  Fensterinhalt  neu  zeichnen. 

wind_update  ( BEG_ UPDATE) ; 

/*  Fensterinhalt  zeichnen  */ 
wind_update  (END.UPDATE) ; 

Anmerkung:  Soil  mit  einem  Accessory  kommuniziert  werden,  so  mufi  END  UPDATE 
eingeschaltet  werden,  damit  die  Nachrichten  und  Quittungen,  die  man  sich  gegenseitig 
sendet,  vom  AES  uberraittelt  werden  konnen. 


- WIND_CALC 

Durch  die  Funktion  wind_calc  kann  der  Arbeitsbereich  oder  Randbereich  eines  Fen- 
sters  berechnet  werden.  Man  iibergibt  die  Position  und  Grdfie  des  Bereiches  und  erhalt 
den  jeweils  anderen  Bereich,  AuBerdem  muB  man  die  Attribute  des  Randbereiches  ange- 
ben,  die  fiir  das  auszurechnende  Fenster  gelten  sollen. 

Beispiel:  Aus  dem  Arbeitsbereich  soli  der  Randbereich  eines  beliebigen  Fensters  berech- 
net werden. 

WORD  kind; 

WORD  X,  y,  w,  h; 

WORD  rx,  ry,  rw,  rh; 

kind  = NAME-t-CLOSER+FULLER;  /*  Fensterattribute  */ 

X = x-Position  des  Arbeitsbereiches 
y = y-Position  des  Arbeitsbereiches 
w = Breite  des  Arbeitsbereiches 
h = Hohe  des  Arbeitsbereiches 

wind_calc  (WC_BORDER,  kind,  x,  y,  w,  h &rx,  &ry,  &rw,  &rh); 

Der  Randbereich  des  Fensters  befindet  sich  in  den  Variablen  rx,  ry,  rw  und  rh. 


- WIND_NEW 

Diese  Funktion  ist  nur  auf  dem  ATARI  ST  ab  TOS  Version  1.4  verfugbar.  Sie  loscht 
und  schlieBt  alle  Fenster,  setzt  die  wind_update-Funktion  zuriick  und  setzt  die  Maus  auf 
den  Pfeil.  Die  Funktion  wird  z.B.  aufgerufen,  wenn  ein  Programm  abgestiirzt  ist  und  man 
zum  Desktop  zuriickkehrt.  In  alteren  TOS-Versionen  konnte  man  dann  im  Desktop  meist 
keine  Menus  mehr  auswahlen,  da  die  abgestiirzte  Applikation  sich  meist  in  der  Zeichen- 
funktion  eines  Fensters  befand  und  dort  die  AES-Funktion  wind  update  (BEG 
UPDATE)  aufgerufen  hatte. 
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10.  RESOURCE-LIBRARY 


no 

— rsrc  load 

Resource-Datei  laden 

111 

- rsrc_free 

Speicher  von  Resource-Dateien  freigeben 

112 

— rsrc_gaddr 

Adressen  von  Objekten  holen 

113 

- rsrc_saddr 

Adressen  von  Objekten  setzen 

114 

— rsrc_obfix 

X,  y,  Breite  und  Hohe  konvertieren 

Ressourcen  einer  Applikation  sind  Fehlermeldungen,  Dialogboxen  und  Meniizeilen.  Sie 
werden  getrennt  vom  Programmcode  der  Applikation  aufbewahrt.  Man  erstellt  sie  mit 
einem  Resource  Construction  Set  und  erhalt  eine  Datei  mit  Suffix  „.RSC“.  Die  Vorteile 
von  Resource-Dateien  liegen  klar  auf  der  Hand:  Mochte  man  z.B,  die  Meldungen  einer 
Applikation  in  eine  andere  Sprache  ubersetzen,  so  muB  nur  die  Resource-Datei  iibersetzt 
werden.  Am  Programmcode  selbst  muB  nichts  geandert  werden. 

Der  nachste  Vorteil  liegt  in  der  Unabhangigkeit  von  verschiedenen  Bildschirmauflosun- 
gen  und  Grafikkarten.  Eine  Dialogbox,  die  15  Textzeilen  hoch  ist  und  z.B.  10  Zeilen  Text 
beinhaltet,  wird  in  alien  Bildschirmauflosungen  die  gleiche  x y-Position  und  Hohe  haben. 
Dies  liegt  daran,  daB  in  der  Resource-Datei  die  x-y-Position  und  die  Breite  und  Hohe  ei- 
ner Dialogbox  in  Vielfachen  von  ZeichensatzgrdBen  angegeben  sind.  Beim  Laden  der 
Resource-Datei  werden  diese  ZeichengroBen  mit  Hilfe  der  Funktion  rsrc_obfix  mit  der 
Breite  und  Hohe  eines  Zeichens  aus  dem  Systemzeichensatz  multipliziert, 

Weitere  Vorteile  ergeben  sich  bei  der  Darstellung  von  Piktogrammen.  In  Resource- 
Dateien  sind  Piktogramme  und  Bit-Images  im  Standardformat  abgelegt.  Bei  Benutzung 
von  anderen  Grafikkarten  konnen  diese  Standardformate  in  das  entsprechende  geratespe- 
zifische  Format  umgewandelt  werden  (siehe  auch  vr  trnfm). 

Durch  die  Darstellung  von  Grdfien  und  Positionen  in  Zeichenkoordinaten  und  durch  die 
Darstellung  von  Piktogrammen  in  Standardformaten  sind  Resource-Dateien  portabel  von 
einer  Prozessorfamilie  zu  einer  anderen  (z.B.  INTEL  SOxxx  zu  Motorola  68xxx  und  um- 
gekehrt). 


- RSRC_LOAD 

- RSRC_FREE 

Das  AES  liest  beim  Aufruf  von  rsrc_load  aus  dem  Kopf  der  Resource-Datei  die  GroBe, 
alloziert  dynamisch  Speicher  und  ladt  die  Datei.  Dann  werden  die  x-y-Positionen  sowie 
die  Breiten  und  Hohen  von  Objekten  an  die  Bildschirmauflosung  angepaBt.  Die  Zeiger 
der  Objekte,  die  z.B.  auf  TEDINFO’s,  ICONBLK’s  usw.  zeigen,  werden  angepaBt  und 
ein  Feld  aufgebaut,  das  Zeiger  auf  alle  Objektbaume  enthalt.  Die  Adresse  dieses  Feldes 
wird  in  global  [5]  und  global  [6]  abgelegt.  Der  Funktionswert  ist  FALSE,  falls  die  Datei 
nicht  geladen  werden  konnte. 
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Bemerkung;  Ab  GEM  2.X  wird  bei  Objektbaumen,  die  als  Wurzel  eine  Box  besitzen 
(z.B.  alle  Dialogboxen),  im  Objektstatus  das  Flag  SHADOWED  gesetzt.  Das  bedeutet, 
daB  alle  Dialogboxen  statt  umrahmt  mil  einem  Schatten  gezeichnet  werden.  Dies  sind 
noch  Folgen  des  Rechtsstreits  von  Digital  Research  Incorporated  mit  Apple  Computer. 
Apple  hatte  den  ProzeB  gewonnen,  so  daB  DRI  einige  kosmetische  Anderungen  ab  GEM 
2.x  vornehmen  muBte.  Z.B.  bekam  der  GEM-Desktop  nur  noch  2 feste  Fenster.  Dialog- 
boxen, bei  denen  im  RCS  das  OUTLINED-Bit  im  Objektstatus  gesetzt  war,  wurden  modi- 
fiziert,  so  daB  jetzt  ein  Schatten  gezeichnet  wird.  Denn  Dialogboxen  mit  umrahmter  Box 
sehen  genau  so  aus  wie  auf  einem  Apple-Macintosh.  Man  kann  das  SHADOWED-Bit 
aber  nach  dem  rsrc_load  zur  Laufzeit  wieder  zuriicksetzen  und  dafiir  das  OUTLINED- 
Bit  setzen  (siehe  RESOURCE. C). 

Dutch  rsrc_free  wird  eine  geladene  Resource-Datei  wieder  freigegeben. 

Beispiel: 

BYTE  *rsrc_name; 
rsrc.name  = "TEST.RSC"; 

if  (!  rsrc_load  (rsc_name))  /*  Resource-Datei  nicht  gefunden  */ 

[ 

strcpy  (s,  "[3] [Resource-File  1 ") ; 
strcat  (s,  rsc_naue); 
strcat  (s,  "?][  EXIT  ]"); 
form_alert  (1,  s); 
return  (FALSE); 

I /*  if  */ 

/*  Aktionen...  */ 

rsrc_f ree  ( ) ; 


- RSRC_GADDR 

Hiermit  holt  man  sich  Adressen  von  Objekten  aus  der  geladenen  Resource-Datei.  Meist 
werden  gleich  nach  dem  Laden  die  Adressen  aller  Objektbaume  geholt,  damit  man  schnell 
auf  diese  zugreifen  kann.  Man  gibt  zuerst  den  Objekttyp,  dann  den  Index  des  Objekts 
{aus  der  Datei  TEST.H,  die  vom  RCS  erzeugt  wurde)  und  die  Variable  an,  in  die  das 
Ergebnis  gespeichert  werden  soli.  Welche  Objekttypen  geholt  werden  konnen,  kann  man 
in  der  Datei  AES.H  nachsehen. 

Beispiel: 

OBJECT  *menu; 

OBJECT  *about; 
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/*  Resource-Date!  laden,  s.o.  ...*/ 

rsrc.gaddr  (R_TREE,  MENU,  &menu) j 
rsrc_gaddr  (R_TREE,  ABOUT,  &about) ; 

objc_draw  (about,  ROOT,  MAX_DEPTH,  xdial,  ydial,  wdial,  hdial); 

Das  Programmstiick  ladt  die  Resource-Datei  und  holt  sich  von  den  beiden  Objekbaumen 
die  Adressen  der  Wurzel  (R_TREE)  in  die  Variablen  menu  und  about.  AnschlieJJend 
wird  die  Dialogbox,  die  am  Objektbaum  about  hangt,  auf  dem  Bildschirm  ausgegeben. 


- RSRC_SADDR 

Dies  ist  die  Umkehrfunktion  zu  rsrc_gaddr.  Allerdings  konnen  nur  die  beiden  Objekt- 
typen  R_FRSTR  und  R_FRIMG  gesetzt  werden,  was  aber  in  der  Praxis  wohl  nie 
vorkommt. 


- RSRC_OBFIX 

Diese  Funktion  wird  von  rsrc_load  aufgerufen.  Wie  oben  erwahnt,  werden  die  x-y- 
Werte  und  die  Breiten  und  Hohen  aller  Objekte  mit  Hilfe  des  Systemzeichensatzes  in 
PixelgroBen  umgewandelt  (siehe  auch  Modul  RCM.C). 

Beispiel:  Konvertiere  das  Wurzelobjekt  der  Dialogbox  about. 

rsrc_obfix  (about,  0); 


11.  SHELL-LIBRARY 


120 

- sheLread 

Erkennt,  wie  eine  Appl.  gestartet  wurde 

121 

- shel_write 

AES  verlassen  oder  Applikation  starten 

124 

- shel_find 

Datei  suchen 

125 

- shel_envrn 

Liest  die  Umgebungsparameter 

126 

- sheLrdef 

Gibt  die  Default- Applikation  zuriick 

127 

- sheLwdef 

Setzt  die  Default- Applikation 

Die  Shell-Library  hat  die  Funktion,  einer  Applikation  die  Mdglichkeit  zu  geben  herauszu- 
finden,  wie  sie  gestartet  wurde.  AuBerdem  konnen  Dateien  gesucht  und  andere  Program- 
me gestartet  werden. 

Unter  MS-DOS  startet  man  das  GEM-System  normalerweise  mit  dem  Kommando  GEM. 
Nachdem  das  VDI  und  das  AES  geladen  sind,  startet  der  GEM-Desktop  als  sogenannte 
Default- Applikation.  Startet  man  vom  Desktop  aus  andere  Programme,  so  kehrt  man 
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automatisch  zur  Default-Applikation  zuriick.  Dies  kann  aber  verandert  werden,  falls  man 
von  einer  Applikation  A eine  andere  Applikation  B aufrufen  mochte  und  nach  Beendigung 
der  Applikation  B wieder  Applikation  A und  nicht  den  GEM-Desktop  starten  mochte. 


- SHEL_READ 


Durch  einen  Aufruf  von  shel_read  bekommt  man  den  Pfad  und  den  Dateinamen  der  ei- 
genen  Applikation  zuriick.  AuBerdem  bekommt  man  die  Kommandozeile  geliefert,  die 
beim  Aufruf  eventuell  ubergeben  wurde  (z.B.  einen  Dateinamen,  wenn  die  Applikation 
im  GEM-Desktop  installiert  und  das  entsprechende  Dokument  angeklickt  wurde). 


Beispiel:  Das  Programm  TEST.APP  wurde  vom  Verzeichnis  D:\GEMAPPS  gestartet, 
indem  die  Datei  CDS. DOC  im  Verzeichnis  C:\WORDPLUS\DOCS  angeklickt  wurde. 
Vorher  wurde  die  Datei  mit  „Anwendung  anmelden...“  vom  GEM-Desktop  aus  in- 
stalliert. 


BYTE  pcmd  [128];  /*  mindestens  128  Zelchen  */ 

BYTE  ptall  [128]; 
shel_read  (pcmd,  ptall) ; 


Die  Zeichenkette  pcmd  enthaltden  Wert  „D:\GEMAPPS\TEST.APP“,  die  Zeichenket- 
te  ptail  enthat  den  Wert  „C: \WORDPLUS\DOCS\CDS.DOC". 


- SHEL_ WRITE 


Hiermit  konnen  andere  Programme  aufgerufen  werden.  Dabei  wird  angegeben,  ob  das 
nachfolgende  Programm  sofort  gestartet  wird  oder  erst,  wenn  die  laufende  Applikation 
beendet  ist.  AuBerdem  wird  mitgeteilt,  ob  es  sich  beim  aufgerufenen  Programm  um  eine 
GEM-Applikation  handelt  oder  nicht,  Der  Name  und  die  Kommandozeile  (siehe 
sheLread)  werden  ebenfalls  ubergeben. 


Die  Ubergabewerte  konnen  folgende  Werte  annehmen: 

doex:  0 = AES  verlassen,  zuriick  zum  Betriebssystem.  Bei  ATARI  ST  wird  warm  ge- 
bootet  (Accessories  werden  neu  geladen,  z.B.  beim  Umschalten  der  Bild- 
schirmaufldsung) . 

1 = andere  Applikation  aufrufen 

isgr:  0 = Textapplikation 

1 = Grafikapplikation 
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isover:  0 = neue  Applikation  zusatzlich  laden 

1 = neue  Applikation  als  Overlay  (im  Speicherbereich  der  alien  Applikation) 

laden 

2 = wie  1,  aber  zusatzlich  das  VDI  aus  dem  Speicher  entfernen 

pcmd  : Dateiname  der  neuen  Applikation 
ptail  : Kommandozeile  fiir  die  neue  Applikation 

Beispiel:  Die  laufende  Applikation  TEST.APP  soli  nach  Beendigung  die  GEM- 
Applikation  NEU.APP  aufrufen,  wobei  ihr  die  Zeichenkette  „Es  war  TEST.APP“  iiber- 
geben  wird.  Dabei  soil  die  alte  Applikation  aus  dem  Speicher  entfernt  werden. 

WORD  doex,  Isgr,  isover; 

BYTE  pcmd  [128]; 

BYTE  ptail [128]; 

doex  = TRUE; 
isgr  = TRUE; 
isover  = TRUE; 

strcpy  (pcmd,  "C:\\GEMAPPS\\NEU.APP") ; 
strcpy  (ptail,  "Es  war  TEST.APP"); 
shel_write  (doex,  isgr,  isover,  pcmd,  ptail); 


- SHEL_FIND 

Hiermit  kann  eine  beliebige  Datei  gesucht  werden.  Wird  sie  gefunden,  so  wird  der  kom- 
plette  Pfad  der  Datei  zuriickgeliefert.  Die  Funktion  shel_find  sucht  im  aktuellen  Pfad 
und  in  alien  Pfaden,  die  in  der  Environment-Variablen  PATH  angegeben  sind. 

Beispiel:  Suche  nach  Dateinamen  CDS. DOC.  Der  Pfad  ist  wie  folgt  eingestellt: 

PATH=C : \ ; C ; \D0S ; C ; \GEMAPPS ; C : \GEKAPPS\VfORDPLUS\DOCS 

BYTE  ppath  [128]; 

strcpy  (ppath,  "CDS. DOC"); 
shel.find  (ppath) ; 

Die  Varibale  ppath  enthalt  nach  dem  Aufruf  von  shel_find  den  Wert  „C:\GE- 
M APPS\WORDPLUS\DOCS\CDS . DOC  “ . 


- SHEL_ENVRN 

Damit  laBt  sich  die  sogenannte  Umgebung  (environment)  des  Betriebssystems  auf  einen 
Parameter  hin  untersuchen.  In  obigem  Beispiel  wurde  z.B.  der  Pfad  in  die 
Betriebssystem-Umgebung  gesetzt.  Mochte  man  z.B.  den  Wert  des  Parameters  PATH  = 
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wissen,  muB  shel_envrn  aufgerufen  werden.  Man  iibergibt  den  Suchbegriff  und  erhalt 
einen  Zeiger  auf  das  Byte,  das  dem  Suchbegriff  folgt. 

Beispiel:  Suche  nach  dem  Wert  des  Umgebungsparameters  PATH  = . 

BYTE  »ppath; 

BYTE  psrch  [128]; 

strcpy  (psrch,  "PATH=")l 
shel_envrn  (&ppath,  psrch); 

Die  Variable  ppath  enthalt  die  Zeichenkette  „C:\;C:\DOS;C;\GEMAPPS;C:\ 
GEMAPPS\WORDPLUS“ . 


- SHEL_RDEF 

Der  Dateiname  sowie  das  Inhaltsverzeichnis  der  Default-Applikation  (s.o.)  wird  ab  GEM 
Version  2.X  zuriickgegeben.  Im  Normalfall  ist  dies  DESKTOP. APP. 

Beispiel; 

BYTE  Ipcmd  [32]; 

BYTE  Ipdir  [128]; 

shel_rdef  (Ipcrad,  Ipdlr); 


- SHEL_WDEF 

Durch  Aufruf  der  Funktion  shel_wdef  kann  die  Applikation  bestimmt  werden,  die  nach 
Beendigung  einer  beliebigen  Applikation  aufgerufen  werden  soil.  Im  Normalfall  ist  die 
Default-Applikation  der  GEM-Desktop  mit  Namen  DESKTOP. APP. 

Beispiel:  Die  Applikation  C:\GEMAPPS\SHELL.APP  soil  als  neuer  Desktop  dienen, 
d.h.  man  soil  von  SHELL  aus  jede  andere  Applikation  aufrufen  konnen  und  nach  Beendi- 
gung der  aufgerufenen  Applikation  soil  wieder  SHELL.  APP  aktiv  werden  an  Stelle  des 
GEM-Desktop. 

BYTE  Ipcmd  [32]; 

BYTE  Ipdir  [128]; 

strcpy  (Ipcmd,  "SHELL. APP") ; 
strcpy  (Ipdir,  "C:\\GEMAPPS\\") ; 
shel.wdef  (Ipcmd,  Ipdir); 


2.4  AES 


161 


Achtung:  Wird  die  eigene  Shell  wieder  gestartet,  so  bekommt  sie  als  Parameter  genau 
die  Werte  geliefert,  die  sie  selbst  an  das  aufgerufene  Programm  iibergeben  hat.  Auf  diese 
Parameter  sollte  die  Shell  dann  nicht  oder  entsprechend  reagieren. 


12.  EXTENDED-GRAPHICS-LIBRARY 


130  — xgrf_stepcalc  Rahmenparameter  berechnen 

131  — xgrf_2box  Sich  bewegende  Boxen  zeichnen 


Da  ab  GEM  2.X  die  Funktionen  graf_growbox  und  graf_shrinkbox  aus  dem  AES  eli- 
miniert  wurden  (wahrscheinlich  auch  wegen  des  Rechtsstreits  mit  Apple),  bietet  das  AES 
diese  beiden  Ersatzfunktionen  an.  Bisher  wurden  sie  von  keiner  Applikation  benutzt.  Wir 
zeigen  aber,  wie  mit  ihnen  die  beiden  fehlenden  Funktionen  aus  der  Graphics-Library 
nachgebildet  werden  konnen. 


- XGRF  STEPCALC 

- XGRF_2BOX 

Mit  der  Funktion  xgrf_stepcalc  berechnet  man  die  Schrittweiten  in  x-  und  y-Richtung 
und  erhalt  die  Werte,  die  man  fiir  die  Funktion  xgrf2box  benotigt. 

Beispiel:  Simulation  der  alten  GEM-l.X-Funktionen  graf_growbox  und  graf_shrink- 
box. 

LOCAL  VOID  graf_growbox  (orgx,  orgy,  orgw,  orgh,  x,  y,  w,  h) 

WORD  orgx,  orgy,  orgw,  orgh; 

WORD  X,  y,  w,  h; 

[ WORD  cx,  cy,  cnt,  xstep,  ystep; 

xgrf.stepcalc  (orgw,  orgh,  x,  y,  w,  h, 

&CX,  &cy,  &cnt,  &Xstep,  &ystep); 
graf_mbox  (orgw,  orgh,  orgx,  orgy,  cx,  cy) ; 
xgrf_2box  (cx,  cy,  orgw,  orgh,  TRUE,  cnt,  xstep,  ystep,  TRUE); 

] /*  graf_growbox  */ 

LOCAL  VOID  graf_shrinkbox  (orgx,  orgy,  orgw,  orgh,  x,  y,  w,  h) 

WORD  orgx,  orgy,  orgw,  orgh;W0RD  x,  y,  w,  h; 

{ WORD  cx,  cy,  cnt,  xstep,  ystep; 

xgrf„stepcalc  (orgw,  orgh,  x,  y,  w,  h, 

&CX,  &cy,  &cnt,  &xstep,  &ystep); 
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xgrf_2box  (x,  y,  w,  h,  TRUE,  cnt,  -xstep,  -ystep,  TRUE); 
graf_mbox  (orgw,  orgh,  cx,  cy,  orgx,  orgy); 

] /X  graf_shrinkbox  */ 

#endif 

Zusamtnenfassung:  Wir  haben  in  diesem  Kapitel  nach  dem  VDI  auch  das  AES  kennenge- 
lernt.  Mit  beiden  Paketen  von  Funktionen  ist  es  moglich  geworden,  gerateunabhangige 
Ausgaben  zu  produzieren  und  fensterorientierte  Software  mit  Menuleisten  und  Dialog- 
boxen  zu  gestalten  und  zu  implementieren. 

Das  AES  bestand  dabei  wie  das  VDI  aus  verschiedenen  Gruppen  von  Funktionen.  Diese 
Gruppen  deckten  die  Ereignisverarbeitung  (Event-Library),  das  Handling  von  Fenstern 
(Window-Library),  das  Anzeigen  von  Meniibaumen  (Menu-Library),  den  Umgang  mit 
Objekten  (Objekt-Library)  usw.  ab. 

Ein  wesentlicher  Gesichtspunkt  war  das  Trennen  der  Aufgaben  des  AES  und  der  Applika- 
tion.  Wahrend  das  AES  die  Verwaltung  der  Meniileiste  und  der  Randkomponenten  der 
Fenster  iibernahm,  war  es  Aufgabe  der  Applikation,  das  Innere  von  Fenstern  zu  zeichnen. 
Dabei  spielte  der  Begriff  der  Nachricht  (Messages)  eine  zentrale  Rolle.  Mit  ihnen  sendet 
das  AES  unserer  Applikation  Nachrichten  (Fenster  neu  zeichnen,  Menii  angewahlt  usw.) 
und  wir  konnen  Nachrichten  an  andere  Applikationen  (oder  Accessories)  senden  (z.B. 
an  einen  Druckerspooler). 

Die  Form-Library  schlieBlich  nahm  uns  die  gesamte  Arbeit  ab,  die  Interaktion  des  Benut- 
zers  mit  einer  Dialogbox  zu  iiberwachen.  Wir  konnten  somit  nach  Beendigung  eines  Dia- 
logs alle  Informationen  aus  dem  Objektbaum  der  Dialogbox  herausholen.  Objektbaume 
haben  wir  auBerdem  durch  benutzerdefinierte  Funktionen  erweitern  konnen  (Checkbo- 
xen,  runde  Radiobuttons). 

In  Kapitel  4 wird  das  kleine  GEM-Programm  SHOWGEM  vorgestellt,  das  den  Umgang 
mit  Dialogboxen  und  benutzerdefinierten  Objekten  verdeutlicht.  Damit  es  nicht  zu  kom- 
pliziert  wird,  wurde  auf  die  Benutzung  von  Fenstern  verzichtet.  Es  zeigt  Metadateien  und 
Bit-Image-Dateien  auf  beliebigen  Ausgabegeraten  an.  Wer  alles  genau  wissen  mdchte, 
mufS  sich  dann  in  die  Beispielapplikation  SCRAP  einlesen,  die  alles  aus  GEM  herausholt, 
was  moglich  ist.  Dabei  werden  keinerlei  Tricks  verwendet,  sondern  nur  saubere  VDI- 
und  AES-Aufrufe.  Wer  seine  Applikationen  so  schreibt,  wie  zum  Beispiel  SCRAP,  kann 
sicher  sein,  daii  er  nicht  eine  einzige  Zeile  umprogrammieren  mu6,  wenn  er  auf  ein  ande- 
res  Betriebssystem  oder  eine  andere  GEM- Version  umsteigt. 


2.5  Resourcen 

In  diesem  Kapitel  soil  noch  kurz  auf  Resource-Dateien  eingegangen  werden.  Es  werden 
ein  Programm  und  ein  Modul  vorgestellt,  die  folgende  Aufgaben  haben: 
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a)  Ein  GEM-Resource-Konverter,  der  Resource-Dateien  von  MC68000-Prozessoren 
nach  INTEL-Prozessoren  uberfuhrt  und  umgekehrt. 

b)  Das  Modul  RCM  (Resource-Create-Modul),  das  es  erlaubt,  die  vom  RCS  erzeugten 
Dateien  mil  Suffix  RSH  (Resource-Header),  welche  C-Quelltexte  von  Resourcen  darstel- 
len,  in  ein  Programm  mil  einzubinden. 


2.5.1  GRC 

Dieses  Programm  kann  auf  einem  ATARI  ST  iibersetzt  und  angewendet  werden.  Es  wan- 
delt  Resource-Dateien  von  MC68xxx-Prozessoren  in  Resourcen  fur  Prozessoren  vom 
Typ  INTEL  80xxx  um.  Dabei  wird  auch  der  Zeichensatz  von  ATARI  und  MS-DOS  be- 
riicksichtigt.  ATARI-Besitzer  kennen  das  Problem  ja  schon  bei  Druckem.  Das  „fi“-  und 
das  „§“-Zeichen  stimmen  nicht  mit  dem  IBM-Zeichensatz  uberein. 


/*  */ 

/*  GEM  resource  converter  for  ATARI  ST  */ 

/»  */ 

/*  used  to  convert  GEM  resource  files  */ 

/*  from  MC68000  to  INTEL  format  and  vice  versa  */ 

/*  */ 

/*  Version:  [1.2]  */ 

/*  Date  : l-February-89  */ 

/*  Authors:  Jiirgen  & Dieter  Geifi  */ 

/»  */ 


# include  <stdio.h> 

# include  <string.h> 

# include  <portab.h> 
# include  <vdi.h> 

# include  <aes.h> 

#if  GEMDOS 
♦include  <osbind.h> 

♦ else 

♦include  <gemdos.h> 
♦include  <dosbind.h> 

♦ endif 
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/»»**»»  DEFINES  **»*»»*»***»**»**»»»***»***»*****»***»**»**»»»»»»»* / 
# define  STRLEN  82 

# define  MAX_RS  65536L  /*  max  64k  resource  files,  must  be  LONG  */ 

/»#*»»»  TYPES  *»»»***»»»*»»**»*»*»*»»»»»»*»»***»»»*»»****»»*»»»*»*» / 
typedef  BYTE  STRING  [STRLEN]; 

/**»»»»  VARIABLES  »»»»»»»*»»»»*»»*»*»*»»»»*»»**»»***»*»»»*»*»*»»**» / 


WORD  handle;  /*  file  handle  */ 
LONG  size;  /»  size  of  file  */ 
STRING  srcname;  /*  source  resource  filename  */ 
STRING  destname;  /»  destination  resource  filename  */ 
STRING  direction;  /»  0 = MC68K  ->  INTEL,  1 = INTEL  ->  MC68K  »/ 
RSHDR  ^header;  /*  resource  header  »/ 
UBYTE  *rsc_buffer;  /*  buffer  for  resource  file  */ 


/*»»*»*  PROTOTYPES  / 

LOCAL  VOID  strupper  .((BYTE  *s)); 

LOCAL  VOID  fllp.word  .((BYTE  *adr)); 

LOCAL  VOID  fllp.long  .( (WORD  *adr) ) ; 

LOCAL  VOID  MC68KtoINTEL  .((VOID)); 

LOCAL  VOID  INTELtoMC68K  .((VOID)); 

/»**»»»  FUNCTIONS  »»»**»»#»»»»***»»»**»»»*»»»**»*»**»»****»»»*»»*»* / 

LOCAL  VOID  strupper  (s) 

REG  BYTE  *s; 

( 

while  (»s) 

( 

if  (('a'  <=  »s)  &&  (»s  <=  'z'))  *s  -=  'a'  - 'A'; 

S++; 

) /»  while  */ 

] /»  strupper  */ 

/»****»»»***»)(*»*»»»»***»»»»»»***»»»»**»***»»»**»*»*»»**^(»*»»»*)HH(»/ 

LOCAL  VOID  fllp.word  (adr) 

REG  BYTE  *adr; 
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{ 

REG  BYTE  c; 

c = adr  [0]; 

adr  [0]  = adr  [1]; 

adr  [1]  = c; 

) /*  flip_word  */ 

/»***»»»»»*»»»»»#**»»»»»*»»*»**»»**»***»»»*»»»»**»»****»»*»**»»**»*/ 

LOCAL  VOID  fllp_long  (adr) 

REG  WORD  *adr; 

[ 

REG  WORD  1; 

i = adr  [0] ; 

adr  [0]  = adr  [1]; 

adr  [1]  = i; 

flip.word  ((BYTE  *)&adr  [0])j 
flip.word  ((BYTE  »)&adr  [1]); 
j /*  flip.long  */ 

LOCAL  VOID  MC68KtoINTEL  () 

{ 

WORD  1,  j,  words; 

WORD  »pmask; 

WORD  *pdata; 

OBJECT  »pobject; 

TEDINFO  *ptedinfo; 

ICONBLK  *piconbllc; 

BITBLK  »pbitblk; 

BYTE  »»pfrstr; 

BITBLK  *pfrirag; 

OBJECT  »*ptr Index; 

UBYTE  »pstring; 

handle  = Fopen  (srcname,  0); 

if  (handle  < 0) 

[ 

printf  ("Error  in  opening  !{s\n",  srcname); 
return; 

) /*  if  */ 
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size  = Fread  (handle,  MAX_RS,  rsc_buffer) ; 
Fclose  (handle); 


flip  data  and  mask  of  iconblocks  *****/ 

piconblk  = (ICONBLK  ») ((ULONG)rsc_buffer  + header->rsh_iconblk); 

for  (i  = 0;  1 < header->rsh_nlb;  1++) 

[ 

words  = piconblk  [i].ib_wicon  / 16  * piconblk  [1] . lb_hlcon; 

pmask  = (WORD  *) ( (ULONG)rsc_buffer  + 

(ULONG)piconblk  [i] . ib_pmask) ; 
for  (j  = 0;  j < words;  j++)  flip.word  ((BYTE  i^)&pmask  [j]); 

pdata  = (WORD  *) ((ULONG)rsc_buffer  + 

(ULONG)piconblk  [i] . Ib.pdata) ; 
for  (j  = 0;  j < words;  j++)  flip.word  ((BYTE  »)&pdata  [j]); 

) /»  for  */ 


/*****  flip  data  of  bltblocks  *****/ 

pbitblk  = (BITBLK  ») ( (ULONG)rsc_buffer  + header->rsh_bltblk) ; 

for  (i  = 0;  i < header->rsh_nbb ; 1++) 

{ 

words  = pbitblk  [l].bi_wb  / 2 * pbitblk  [i].bi_hl; 

pdata  = (WORD  *) ( (ULONG)rsc_buffer  + 

(ULONG)pbitblk  [i] .bi_pdata) ; 

for  (j  = 0;  j < words;  j-H-)  flip_word  ((BYTE  *)&pdata  [j]); 
] /*  for  */ 


/»»***  flip  objects  *****/ 


pobject  = (OBJECT  *) ( (UL0NG)rsc_buffer  + header->rsh_object) ; 


for  (i  = 0; 
[ 

flip.word 

fllp_word 

fllp_word 

flip_word 

flip.word 

flip_word 

fllp_long 


i < header->rsh_nobs;  1++) 

((BYTE  »)&pobject  [i] .ob_next) ; 
((BYTE  »)&pobject  [i] .ob_head) ; 
((BYTE  »)&pobject  [i] .ob_tail) ; 
((BYTE  »)8cpobject  [i]  .ob_type) ; 
((BYTE  »)&pobject  [i] .ob_flags) ; 
((BYTE  »)&pobject  [i] .ob_state) ; 
((WORD  »)8cpobject  [i]  .ob_spec) ; 
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flip^word  ((BYTE  *)&pobject  [i].ob_x); 
flip.word  ((BYTE  *)&pobject  [l].ob_y); 
flip_word  ((BYTE  *)&pobjbct  [i] .ob .width) ; 
flip.word  ((BYTE  *)&pobject  [i] .ob.helght) ; 

] /*  for  */ 

/****»  flip  tedinfos 

ptedinfo  = (TEDINFO  *) ((ULONG)rsc.buffer  + header->rsh_tedinfo) ; 

for  (1=0;  i < header->rsh_nted;  1++) 

flip.long  ((WORD  *)&ptedinfo  [1] .te.ptext) ; 
flip.long  ((WORD  »)&ptedinfo  [i] .te.ptmplt) ; 
flip.long  ((WORD  »)&ptedinfo  [i] .te_pvalid) ; 
flip.word  ((BYTE  *)&ptedinfo  [i] .te.font) ; 
fllp.word  ((BYTE  *)&ptedlnfo  [i]  .te.juiikl) ; 
fllp.word  ((BYTE  *)&ptedinfo  [i] .te.just) ; 
flip.word  ((BYTE  *)&ptedinfo  [i] .te.color) ; 
flip.word  ((BYTE  *)8eptedlnfo  [i]  .te_junk2) ; 
flip.word  ((BYTE  *)&ptedinfo  [1] .te.thiekness) ; 
fllp-word  ((BYTE  *)&ptedinfo  [i] .te_txtlen) ; 
flip.word  ((BYTE  *)&ptedinfo  [1] .te.tmplen) ; 

] /*  for  */ 

/*^f**»  flip  iconblocks  *****/ 

piconblk  = (ICONBLK  *) ((ULONG)rsc_buffer  + header->rsh_iconblk) ; 

for  (i  = 0;  i < header->rsh.nlb;  i++) 

[ 

flip.long  ((WORD  *)&piconblk  [i] . ib.praask) ; 
flip.long  ((WORD  *)&piconblk  [1] . ib.pdata) ; 
flip.long  ((WORD  *)&piconblk  [1] . ib.ptext) ; 
flip.word  ((BYTE  *)&piconblk  [1] . ib.char) ; 
flip.word  ((BYTE  *)8cpiconblk  [i] . ib_xchar) ; 
flip.word  ((BYTE  *)&piconblk  [i] . ib_ychar) ; 
flip.word  ((BYTE  *)&piconblk  [i] . ib.xlcon) ; 
flip.word  ((BYTE  *)&piconblk  [i] . Ib.yicon) ; 
flip.word  ((BYTE  *)&piconblk  [i] . Ib.wicon) ; 
flip.word  ((BYTE  *)&piconblk  [1] . ib.hicon) ; 
flip.word  ((BYTE  *)&piconblk  [1] . Ib.xtext) ; 
flip.word  ((BYTE  *)&pieonblk  [1] . ib.ytext) ; 
flip.word  ((BYTE  *}8rplconblk  [1] . ib.wtext) ; 
flip.word  ((BYTE  *)&plconblk  [i] . Ib.htext) ; 

] /*  for  »/ 
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/****»  flip  bltblocks  *****/ 


pbitblk  = (BITBLK  *) ( (ULONG)rsc_buffer  + header->rsh_bitblk) ; 


for  (1=0; 
( 

flip_long 
flip.word 
fllp.word 
flip_word 
flip_word 
fllp_word 
j /*  for  */ 


1 < header->rsh_nbb ; i++) 


((WORD  »)&pbltblk 
((BYTE  »)&pbitblk 
((BYTE  »)&pbitblk 
((BYTE  *)&pbitblk 
((BYTE  *)&pbitblk 
((BYTE  *)&pbltblk 


[1]  .bl_pdata) ; 

[l].bi_wb); 

[l].bi_hl); 

[i].bi_x); 

[i].bl_y); 

[i] .bl_color) ; 


/»»*»*  flip  free  strings  »*»»»/ 


pfrstr  = (BYTE  »*)  ((ULONG)rsc_buffer  + header->rsh_frstr) ; 
for  (1=0;  i < header->rsh_nstrlng;  1++) 
fllp_long  ((WORD  »)&pfrstr  [i]); 


/*»»»»  flip  free  images  *****/ 


pfrimg  = (BITBLK  ») ( (ULONG)rsc_buffer  + header->rsh_frlmg) ; 
for  (i  = 0;  i < header->rsh_nlmages;  i++) 
flip_long  ((WORD  »)&pfrimg  [i]); 

/»**»»  flip  trees  »»**»/ 


ptrindex  = (OBJECT  »*) ((ULONG)rsc_buffer  + header->rsh_trlndex) ; 
for  (i  = 0;  1 < header->rsh_ntree;  i++) 
fllp_long  ((WORD  »)&ptrlndex  [i]); 

/*  fix  font  from  ATARI  to  IBM  »/ 

pstrlng  = (UBYTE  ») ( (UL0NG)rsc_buffer  + header->rsh_strlng) ; 

while  (pstring  < (UBYTE  ») ( (UL0NG)rsc_buffer  + header->rsh_imdata) ) 

{ 

if  (*pstrlng  ==  221)  *pstring  = 21; 

if  (*pstring  ==  158)  *pstrlng  = 225; 
pstring++; 

] /*  while  */ 
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flip_header  *****/ 


fllp.word  ((BYTE 
fllp.word  ((BYTE 
flip.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 
fllp.word  ((BYTE 

handle  = Fcreate 

If  (handle  < 0) 

[ 

prlntf  ("Error 

return; 
j /*  If  »/ 


*) &header->rsh_vrsn) ; 
*)&header->rsh.object) ; 
*)&header->rsh.tedlnfo) ; 
*) &header->rsh.lconblk) ; 
*) &header->rsh.bltblk) ; 
») &header->rsh_frstr) ; 
»)&header->rsh.strlng) ; 
*)&header->rsh.lmdata) ; 
*) &header->rsh.frlmg) ; 

») &header->rsh.tr Index) ; 
* ) &header->rsh.nobs ) ; 
»)8cheader->rsh.ntree) ; 

»)  8cheader->rsh.nted) ; 

»)  8cheader->rsh.nlb) ; 

*)  &header->rsh.nbb) ; 
*)&header->rsh.nstrlng) ; 
*)&header->rsh.nlmages) ; 
»)8eheader->rsh.rsslze) ; 

(destname,  0x0); 


In  creating  ?s\n",  destname); 


size  = Fwrlte  (handle,  size,  rsc.buf fer) ; 
Fclose  (handle) ; 

] /*  MC68KtoINTEL  */ 


LOCAL  VOID  INTELtoMC68K  () 


{ 

WORD  1,  j,  words; 

WORD  *pmask; 

WORD  »pdata; 

OBJECT  *pobject; 

TEDINFO  »ptedlnfo; 

ICONBLK  *plconblk; 

BITBLK  *pbltblk; 

BYTE  »»pfrstr; 

BITBLK  Jtpfrlmg; 

OBJECT  »»ptrlndex; 

UBYTE  *pstrlng;  handle  = Fopen  (srcname,  0); 
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if  (handle  < 0) 

{ 

prlntf  ("Error  In  opening  ?s\n",  srcname) ; 
return; 

) /»  if  */ 

size  = Fread  (handle,  MAX_RS,  rsc_buf fer) ; 

Fclose  (handle) ; 

/»»»*»  flip.header  *****/ 

flip_word  ((BYTE  *)&header->rsh_vrsn) ; 
flip.word  ((BYTE  »)&header->rsh_object) ; 
flip_word  ((BYTE  *)&header->rsh_tedinfo) ; 
flip_word  ((BYTE  »)&header->rsh_iconblk) ; 
flip_word  ((BYTE  »)&header->rsh_bitblk) ; 
flip_word  ((BYTE  »)&header->rsh_frstr) ; 
flip_word  ((BYTE  »)&header->rsh_string) ; 
flip_word  ((BYTE  »)&header->rsh_imdata) ; 
flip_word  ((BYTE  *)&header->rsh_frimg) ; 
flip_word  ((BYTE  »)&header->rsh_trindex) ; 
flip_word  ((BYTE  *) &header->rsh_nobs) ; 
flip_word  ((BYTE  »)&header->rsh_ntree) ; 
flip_word  ((BYTE  *)&header->rsh_nted) ; 
flip.word  ((BYTE  »)&header->rsh_nib) ; 
flip_word  ((BYTE  *)&header->rsh_nbb) ; 
flip_word  ((BYTE  »)&header->rsh_nstring) ; 
flip_word  ((BYTE  ») &header->rsh_nimages) ; 
flip_word  ((BYTE  *)&header->rsh_rssize) ; 

/*  fix  font  from  IBM  to  ATARI  */ 

pstring  = (UBYTE  *) ((ULONG)rsc_buffer  + header->rsh_string) ; 

while  (pstring  < (UBYTE  ») ( (ULONG)rsc_buffer  + header->rsh_iradata)) 

( 

if  (*pstring  ==  21)  *pstring  = 221; 

if  (*pstring  ==  225)  *pstring  = 158; 
pstring++; 
j /*  while  »/ 

/»**»*  fix  objects  *****/ 

pobject  = (OBJECT  ») ( (ULONG)rsc_buffer  + header->rsh_object) ; 
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for  (i  = 0;  i < header->rsh_nobs;  i++) 

flip.word  ((BYTE  *)&pobject  [i] .ob_next) ; 
fllp.word  ((BYTE  *)&pobject  [i] .ob.head) ; 
flip_word  ((BYTE  *)S:pobject  [i]  .ob_tail) ; 
flip.word  ((BYTE  *)8epobject  [i]  .ob_type) ; 
flip.word  ((BYTE  *)&pobject  [i] .ob.flags) ; 
flip.word  ((BYTE  ^t)g(pobject  [i]  .ob.state) ; 
flip.long  ((WORD  *)&pobject  [i] .ob.spec) ; 
flip.word  ((BYTE  *)8£pobject  [i].ob.x); 
flip.word  ((BYTE  *)&pobject  [i].ob_y)j 
flip.word  {(BYTE  *)&pobJect  [1] .ob.width) ; 
flip.word  {(BYTE  *)&pobject  [i] -ob.height) ; 

] /*  for  »/ 

/***»*  flip  tedinfos  »****/ 

ptedinfo  = (TEDINFO  *) ( (ULONG)rse.buffer  + header->rsh.tedinfo) ; 

for  (i  = 0;  i < header->rsh_ntedj  i++) 

{ 

flip.long  {(WORD  *)&ptedinfo  [i] .te.ptext) ; 
flip.long  {(WORD  *)&ptedinfo  [i] .te.ptmplt) ; 
flip.long  {(WORD  *)&ptedinfo  [i] .te.pvalid) ; 
flip.word  ((BYTE  *)&ptedinfo  [i] .te.font) ; 
flip.word  ((BYTE  *)&ptedinfo  [i] .te.junkl) ; 
flip.word  ({BYTE  *)&ptedinfo  [i] .te.just) ; 
flip.word  ({BYTE  *)&ptedinfo  [i] .te.color) ; 
flip.word  ({BYTE  *)&ptedinfo  [i] .te_junk2) ; 
flip.word  ({BYTE  *)&ptedinfo  [i] -te.thickness) ; 
flip.word  ((BYTE  )^)&ptedinfo  [i]  .te.txtlen) ; 
flip.word  ((byte  *)&ptedinfo  [i] .te.tmplen) ; 

] /*  for  */ 

/»»»**  flip  iconblocks  *»»**/ 

piconblk  = (ICONBLK  *) ( (ULONG)rsc.buffer  + header->rsh.iconblk) ; 
for  (i  = 0;  i < header->rsh.nib;  i++) 

I 

flip.long  ((WORD  *)&piconblk  [i] .ib.pmask); 
flip.long  ((WORD  *)&pioonblk  [i] .ib.pdata); 
flip.long  ((WORD  »)8epiconblk  [i].ib.ptext); 
flip.word  ((BYTE  *)&pleonblk  [i] . ib.ehar) ; 
flip.word  ((BYTE  *)&piconblk  [i] . ib.xchar) ; 
flip.word  ((BYTE  *)&piconblk  [i].ib.ychar); 
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flip^word 
flip_word 
flip. word 
fllp_word 
fllp_word 
flip_word 
flip.word 
fllp_word 
] /*  for  */ 


((BYTE  *)&plconbllc 
((BYTE  *)&piconblk 
((BYTE  »)&piconblk 
((BYTE  »)&plconbllc 
((BYTE  *)&piconblk 
((BYTE  »)&piconblk 
((BYTE  *)&piconbllc 
((BYTE  *)&piconbllc 


[i] . ib_xicon) ; 
[i].ib_ylcon); 
[1] . ib_wlcon) ; 
[1] . ib_hlcon) ; 
[i] .lb_xtext) ; 
[1] .lb_ytext) ; 
[1] .ib.wtext) ; 
[i] .lb_htext) ; 


/***»*  flip  bltblocks  »***»/ 

pbltblk  = (BITBLK  ») ( (ULONG)rsc_buffer  + header->rsh_bltblk) ; 


for  (1  = 0; 
[ 

flip-long 
fllp_word 
fllp.word 
fllp_word 
fllp_word 
flip.word 
] /*  for  »/ 


i < header->rsh_nbb;  1++) 


((WORD  »)&pbltblk 
((BYTE  »)&pbltblk 
((BYTE  »)&pbltblk 
((BYTE  »)&pbitblk 
((BYTE  »)&pbltblk 
((BYTE  »)&pbltblk 


[i]  .bl_pdata) ; 

[l].bi_wb)j 

[i].bi_hl); 

[i].bl_x); 

[i].bi-y)j 

[i]  .bi_color) ; 


/»»»*»  flip  free  strings  *****/ 

pfrstr  = (BYTE  »») ( (ULONG)rsc_buffer  + header->rsh_frstr) ; 
for  (i  = 0;  1 < header->rsh_nstrlng;  1++) 
flip.long  ((WORD  »)&pfrstr  [1]); 


/*»»**  flip  free  images  **»»*/ 


pfrirag  = (BITBLK  ») ((ULONG)rsc_buffer  + header->rsh_frimg) ; 
for  (i  = Oj  i < header->rsh_niraages;  i++) 
flip.long  ((WORD  *)&pfrimg  [i]); 

flip  trees  »»**»/ 

ptrindex  = (OBJECT  »*) ((ULONG)rsc_buffer  + header->rsh_trindex) ; 
for  (1=0;  1 < header->rsh_ntree;  i++) 
flip_long  ((WORD  »)&ptrlndex  [1]); 

/»»*»»  flip  data  and  mask  of  iconblocks  **»*»/ 

piconblk  = (ICONBLK  ») ((ULONG)rsc_buffer  + header->rsh_lconblk) ; 
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for  (1=0;  i < header->rsh_nib ; i++) 

{ 

words  = plconblk  [i].ib_wicon  / 16  * piconblk  [i] .lb_hicon; 

pmask  = (WORD  *) ( (ULONG)rsc_buffer  + 

(ULONG) piconblk  [i] . ib_pmask) ; 
for  (j  = 0;  j < words;  j++)  flip_word  ((BYTE  »)&pmask  [j]); 

pdata  = (WORD  »)( (ULONG) rsc_buffer  + 

(ULONG)plconblk  [1] . ib_pdata) ; 
for  (j  = 0;  j < words;  j++)  flip_word  ((BYTE  *)&pdata  [j]); 
] /»  for  */ 

/«»*»»  flip  data  of  bitblocks  **»»»/ 

pbitblk  = (BITBLK  *)( (ULONG) rsc.buffer  + header->rsh_bitblk) ; 

for  (1=0;  1 < header->rsh_nbb;  1++) 

( 

words  = pbitblk  [i].bl_wb  / 2 * pbitblk  [l].bi_hl; 

pdata  = (WORD  »)( (ULONG) rsc.buffer  + 

(ULONG)pbitblk  [1] .bi_pdata) ; 

for  (j  = 0;  j < words;  j++)  flip_word  ((BYTE  *)8epdata  [J]); 
] /»  for  */ 

handle  = Fcreate  (destnarae,  0x0); 
if  (handle  < 0) 

prlntf  ("Error  in  creating  /5s\n",  destname); 
return; 
j /*  if  »/ 

size  = Fwrite  (handle,  size,  rsc_buffer) ; 

Fclose  (handle) ; 

) /»  INTELtoMC68K  »/ 


GLOBAL  WORD  main  (argc,  argv) 
WORD  argc; 

BYTE  *argv  []; 
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[ 

printf  ("\n\n»»**»  GEM  resource  converter  [1.2]  ; 

rsc.buffer  = (UBYTE  »)Malloc  (MAX_RS); 
header  = (RSHDR  »)rsc_bufferj 

if  (rsc_buffer  ==  NULL) 

( 

printf  ("Error  in  allocating  buffer  for  resource  fileXn"); 
return  (l); 

) /*  if  */ 

if  (argc  < 3) 

( 

printf  ("Source  resource  file  (without  suffix  .RSC):  "); 
gets  (srcname); 

printf  ("Direction:  0 = MC68000  ->  INTELXn"); 

printf  O'  1 = INTEL  ->  MC68000Xn"); 

printf  ("Direction:  "); 
gets  (direction); 

] /»  if  */ 
else 
[ 

strcpy  (srcname,  argv  [1]); 

strcpy  (direction,  argv  [2]); 

j /*  else  »/ 

strcat  (srcname,  ".RSC"); 
strupper  (srcname); 
strcpy  (destname,  srcname); 

if  (direction  [0]  ==  '0') 

MC68KtoINTEL  (); 
else 

INTELtoMC68K  (); 

printf  ("Conversion  finishedXn") ; 
return  (0); 

] /*  main  */ 


Zur  Bedienung  ist  folgendes  zu  sagen:  Startet  man  das  Programm  als  TOS-Programm 
ohne  Parameter,  so  kommt  zuerst  die  Abfrage  nach  der  Resource-Datei.  Dort  mufi  der 
Name  ohne  das  Suffix  „.RSC“  angegeben  werden. 
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AnschlieJlend  erfolgt  die  Abfrage,  in  welche  Richtung  die  Datei  konvertiert  werden  soil: 

Eine  Angabe  einer  0 konvertiert  die  Datei  vom  68000-Format  ins  INTEL-Format,  eine 
1 vom  INTEL-Format  ins  68000-Format. 

Das  Programm  kann  auch  von  einer  Kommando-Shell  aus  gestartet  werden.  Man  iibergibt 
den  Namen  und  die  Transformationsrichtung.  Beispiel:  Wandeln  der  Datei  SHOW- 
GEM. RSC  vom  68000-  ins  INTEL-Format. 

grc  showgem  0 

Wird  die  Konvertierung  erfolgreich  abgeschlossen,  erscheint  die  Meldung:  ..Conversion 
finished". 

Die  angegebene  Datei  wird  unter  dem  gleichen  Namen  konvertiert.  so  daB  nach  obigem 
Beispiel  die  Datei  SHOWGEM. RSC  jetzt  im  INTEL-Format  vorliegt.  Hat  man  verse- 
hentlich  seine  einzige  Resource-Datei  auf  diese  Weise  bearbeitet.  so  geniigt  eine  Ruck- 
transformation  in  die  andere  Richtung.  Mathematisch  ausgedriickt  heiBt  dies,  daB  die 
Rucktransformation  einer  Transformation  einer  Resource-Datei  wieder  die  Ursprungs- 
datei  ergibt.  Jede  Transformation  ist  also  das  inverse  Element  der  Rucktransformation, 

Zum  Algorithmus  ist  zu  sagen,  daB  in  der  Transformation  von  MC68000  nach  INTEL 
der  Kopf  der  Resource-Datei  zuletzt  umgewandelt  wird,  da  dieser  bis  zum  SchluB  fur  die 
Berechnungen  der  Zeiger  auf  die  Objektstrukturen  benotigt  wird.  In  der  anderen  Richtung 
(INTEL  nach  MC68000)  wird  zunachst  der  Kopf  umgewandelt,  damit  man  ihn  in  der 
68(X)0-Prozessorumgebung  benutzen  kann.  Das  Programm  GRC  ist  ein  anschauliches 
Beispiel  fur  die  Benutzung  des  Kopfes  einer  Resource-Datei.  Man  sieht  sehr  schon,  wie 
man  sich  die  Informationen  zu  den  einzelnen  Objekttypen  beschaffen  kann. 


2.5,2  RCM 


Um  zu  verstehen,  wie  das  Resource-Create-Modul  arbeitet,  muB  man  wissen,  wie  die 
AES-Funktion  rsrc_load  auf  eine  Resource-Datei  nach  dem  Laden  wirkt. 


Nachdem  rsrc_load  den  Kopf  der  Resource-Datei  geladen  hat,  um  deren  Lange 
(rsh_rssize)  festzustellen,  alloziert  es  dynamisch  Speicher  und  ladt  den  Rest  der  Datei 
ein.  Der  Kopf  einer  Resource-Datei  ist  in  C wie  folgt  definiert  (siehe  AES.H): 


typedef  struct  rshdr 

UWORD  rsh_vrsn; 
UWORD  rsh.object; 
UWORD  rsh_tedlnfo; 
UWORD  rsh_iconblk; 
UWORD  rsh_bitblk; 


*/ 


/*  list  of  ICONBLKS 
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UWORD  rsh_frstr; 
UWORD  rsh_strlng; 
UWORD  rsh_imda-ta; 
UWORD  rsh_frirag; 
UWORD  rsh_trindex; 
UWORD  rsh_nobs; 
UWORD  rsh_ntree; 
UWORD  rsh_nted; 
UWORD  rsh_nib; 
UWORD  rsh_nbb; 
UWORD  rsh_nstrlng; 
UWORD  rsh_niraages; 
UWORD  rsh_rsslze; 

] RSHDR; 


/*  image  data 


/*  counts  of  various  structs  */ 


/*  total  bytes  in  resource  */ 


Danach  werden  folgende  Anpassungen  vorgenommen: 

a)  Anderungen  der  Werte  ob_x,  ob_y,  ob_width  und  ob_height  an  die  momentane 
Bildschirmauflosung 

b)  Modifizieren  der  Zeiger  aus  den  Strukturen  OBJECT  (ob_spec),  TEDINFO 
(te_ptext,  te_ptmplt,  te_pvalid),  BITBLK  (bi_pdata)  und  ICONBLK  (ib_pmask, 
ib_pdata,  ib_ptext). 

c)  Aufbauen  eines  Feldes  von  Zeigem,  die  auf  jeden  Objektbaum  verweisen. 

d)  Speichern  der  Adresse  des  Feldes  aus  c)  im  AES-Feld  global  [5]  und  global  [6]. 

Genau  diese  Schritte  (auBer  d),  fiihrt  das  Modul  RCM  ebenfalls  aus.  Dazu  benutzt  es  u.a. 
die  Funktion  rsrc_obfix,  die  die  Anpassung  aus  a)  automatisch  vomimmt  (siehe  auch 
Modul  RESOURCE  aus  der  Applikation  SCRAP). 

Die  Header-Datei  RCM.H,  die  man  inkludieren  muB,  sieht  wie  folgt  aus: 


/»  */ 

/»  Modul:  RCM.H  */ 

/*  Datum:  16/04/89  */ 

*/ 


#ifndef  __RCM__ 

# define  __RCM__  / 


/**«»*»  DEFINES  »»»»***JnHHHHt»**»»»**»»»«*1HHHHHt»>**»**»»»»»>****** / 
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/»»»»»»  TYPES  *************************^*************************** / 

typedef  struct 

( 

WORD  dunimy; 

WORD  * image; 
j RS_IMDOPE; 

/*»**»»  VARIABLES 

/**»»»»  FUNCTIONS  »****»»**»**»*»*****»»**»»**»»»*»»*»»**»*»»*****» / 
#if  ANSI 


GLOBAL  VOID  rsc.create  (WORD 

tree, 

WORD 

n_obs, 

WORD 

n_frstr, 

WORD 

n_frimg, 

BYTE 

**rs_strings 

LONG 

*rs_frstr, 

BITBLK 

»rs_bitbllc, 

LONG 

»rs_frimg, 

ICONBLK 

*rs_iconblk, 

TEDINFO 

*rs_tedinfo, 

OBJECT 

*rs_object, 

OBJECT 

*»rs_trindex 

RS.IMDOPE  *rs.imdope); 

#else 


GLOBAL  VOID  rsc.create  ( ) ; 
#endif 

#endif  /*  __RCM„  »/ 


Die  Implemetierung  des  Moduls  in  C lautet: 
/***»***»»»»»»*»**»»*»»»****»*»»»»»*»»»**»»»»***»»*»»»»»**»»»»**»*»/ 


/*  »/ 

/»  Modul:  RCM.C  */ 

/*  Datum:  18/05/89  »/ 

/»  »/ 


♦include  <portab.h> 
♦include  <aes.h> 
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# include  "rcra.h" 

/»»»»*»  DEFINES  »********»#»»»ft*»»******^Hnnnf»»*»*********»*»»****»/ 

TYPES  »***»***»**»»**1Ht)t**»****^(^HHHt*»»*»5f****»****»»»*»»*»/ 

/»***it»  VARIABLES  **»»*****»»###1«'**»**»»**##***»»*««»***»»^t*******»/ 

/*****»  FUNCTIONS  **»»***»»*^nHHHt)t»»»»******#»»»**»»****»»»»***»»**/ 

/******  PROTOTYPES  *****»******)(*************»**■***************»**** / 

LOCAL  VOID  fix^tree  _((WORD  n_tree,  OBJECT  »»rs_trindex, 

OBJECT  *rs_object))j 

LOCAL  VOID  fix_tedlnfo  _((WORD  object,  OBJECT  *rs_object, 

TEDINFO  »rs_tedinfo,  BYTE  *»rs_strings) ) ; 
LOCAL  VOID  fix^ltblk  .((WORD  object,  OBJECT  *rs_object, 

BITBLK  *rs_bitblk,  RS.IMDOPE  »rs_imdope) ) ; 
LOCAL  VOID  fix_string  _((WORD  object,  OBJECT  *rs_object, 

byte  *»rs_strlngs) ) ; 

LOCAL  VOID  fix.iconblk  .((WORD  object,  OBJECT  *i-s_object, 

ICONBLK  »rs_iconblk,  RS.IMDOPE  *rs_imdope, 
byte  **rs_strlngs) ) ; 

LOCAL  VOID  fix_frimg  .((WORD  object,  LONG  *rs.frimg, 

BITBLK  *rs.bltblk,  RS.IMDOPE  »rs„imdope) ) ; 

/**********x*»xx»»JHHnnntx****x***innnt)t)f*»***x*x*»**»***»*«****«**)Hf/ 

LOCAL  VOID  fix_tree  (n_tree,  rs.trindex,  rs.object) 

REG  WORD  n_treej 
REG  OBJECT  »»rs.tr index; 

REG  OBJECT  »rs_object; 

[ 

REG  WORD  tree;  /*  index  for  trees  */ 

REG  WORD  object;  /*  index  for  objects  */ 

REG  WORD  help; 

REG  OBJECT  *pobject; 

for  (tree  = 0;  tree  < n.tree;  tree++)  /*  fix  trees  */ 

{ 

help  = (WORD) rs.trindex  [tree]; 

rs.trindex  [tree]  = (OBJECT  *)&rs.object  [help]; 


I 
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object  = 0; 

pobject  = rs_trindex  [tree]; 

while  (!  (pobject  [object] .ob_f lags  8e  LASTOB)) 

( 

rsrc_obfix  (pobject,  object);  /*  fix  xywh  of  objects  */ 
object++; 

] /*  while  »/ 

rsrc_obfix  (pobject,  object);  /*  at  least  one  object  */ 

] /*  for  */ 

] /*  fix_tree  */ 


LOCAL  VOID  fix_tedinfo  (object,  rs_object,  rs.tedinfo,  rs.strings) 
REG  WORD  object; 

REG  OBJECT  »rs_object; 

REG  TEDINFO  »rs_tedinfo; 

REG  BYTE  **rs_strings; 

[ 

REG  WORD  index; 

index  = (W0RD)rs_object  [object] .ob_spec; 

rs_object  [object] .ob_spec  = (L0NG)&rs_tedinfo  [index]; 

rs_tedinfo  [index] .te_ptext  = 

rs_strings  [(W0RD)rs_tedinfo  [index] .te_ptext] ; 

rs_tedinfo  [index] .te_ptmplt  = 

rs_strings  [(W0RD)rs_tedinfo  [index] .te_ptmplt] ; 

rs.tedinfo  [index] .te_pvalid  = 

rs_strings  [(W0RD)rs_tedinfo  [index] .te.pvalid] ; 

] /»  fix_tedinfo  »/ 

LOCAL  VOID  fix_bitblk  (object,  rs_object,  rs_bitblk,  rs.imdope) 
REG  WORD  object; 

REG  OBJECT  *rs_object; 

REG  BITBLK  »rs.bitblk; 

REG  RS_IMD0PE  *rs_iradope; 


180 


2 GEM  und  sein  Umfeld 


[ 

REG  WORD  indexl; 

REG  WORD  index2; 

indexl  = (WORD)rs_object  [object] .ob_spec; 
index2  = (W0RD)rs_bitblk  [indexl] .bl.pdata; 


rs_bitblk  [indexl] .bi_pdata  = rs_iradope  [index2] . image; 
rs_object  [object] .ob_spec  = (L0NG)&rs_bitblk  [indexl]; 
) /*  fix_bltblk  »/ 


LOCAL  VOID  fix_string  (object,  rs_object,  rs_strlngs) 


REG  WORD 
REG  OBJECT 
REG  BYTE 


object; 

»rs_object; 

»»rs_strings; 


[ 

rs_object  [object] .ob_spec  = 
) /*  fix_string  */ 


(LONG)rs_strlngs 

[(WORD)rs_object  [object] .ob_spec] ; 


LOCAL  VOID  fix_iconblk  (object,  rs_object,  rs_iconblk, 

rs_imdope,  rs.strings) 

REG  WORD  object; 

REG  OBJECT  »rs_object; 

REG  ICONBLK  »rs_iconblk; 

REG  RS.IMDOPE  *rs_imdope; 

REG  BYTE  **rs_strings; 

[ 

REG  WORD  indexl; 

REG  WORD  index2; 


indexl  = (WORD)rs_object  [object] .ob_spec; 

index2  = (WORD)rs_iconblk  [indexl] .lb _pmask; 
rs_iconblk  [indexl] . ib_pmask  = rs_imdope  [lndex2] .image; 


lndex2  = (WORD)rs_lconblk  [indexl] .ib_pdata; 
rs_iconblk  [indexl] .ib_pdata  = rs_imdope  [index2] .image; 
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lndex2  = (WORD)rs_lconblk  [Indexl] .ib_ptext; 
rs.iconblk  [Indexl] .lb_ptext  = rs_strlngs  [lndex2]; 

rs_obJect  [object]  .ob_spec  = (L0NG)8ers_lconblk  [indexl]; 

] /*  flx_iconblk  */ 

/*»*»»»*»*»»»»»*»»**»**»*»»*»*»****»***»»**»*»*»*»»*»*»»*»***»»*»*»/ 

LOCAL  VOID  fix_frimg  (object,  rs_frlmg,  rs_bltblk,  rs_imdope)REG  WOPID 
object; REG  LONG 
»rs_frlmg;REG  BITBLK 
*rs_bitblk;REG  RS_IMDOPE  ^(rs_imdope; 

REG  WORD  Indexl; 

REG  WORD  index2; 

indexl  = (WORD)rs_frimg  [object]; 

index2  = (WORD)rs_bitblk  [indexl] .bl_pdata; 

rs_bitblk  [Indexl] .bi_pdata  = rs_imdope  [index2] .image; 
rs_frimg  [object]  = (LONG)&rs_bitblk  [indexl]; 

] /»  fix_frimg  */ 

GLOBAL  VOID  rsc.create  (n_tree,  n_obs,  n_frstr,  n_frimg, 

rs.strings,  rs_frstr,  rs_bitblk, 
rs_frlmg,  rs_iconblk,  rs_tedinfo, 
rs.object,  rs.trindex,  rs_imdope) 

WORD  n_tree ; 

WORD  n_obs; 

WORD  n_frstr; 

WORD  n_frirag; 

BYTE  *»rs_strings; 

LONG  »rs_frstr; 

BITBLK  »rs_bltblk; 

LONG  »rs_frimg; 

ICONBLK  *rs_iconblk; 

TEDINFO  *rs.tedinfo; 

OBJECT  *rs_object; 

OBJECT  »*rs_trindex; 

RS_IMDOPE  *rs_imdope; 


{ REG  WORD  object;  /*  index  for  objects  »/ 
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fix_tree  (n_tree,  rs_trindex,  rs_object); 


for  (object  = 0;  object  < n_obs;  object  ++)  /*  fix  objects  */ 
[ 

switch  (rs_object  [object] .ob_type  & OxFF) 

{ 


case 

G_B0X 

: break; 

case 

G_TEXT 

: fix_tedinfo  (object,  rs_object,  rs_tedinfo, 
rs_strlngs) ; 

break; 

case 

G_B0XTEXT 

: flx_tedinfo  (object,  rs_object,  rs_tedinfo, 
rs.strlngs) ; 

break; 

case 

G_  IMAGE 

: fix_bitblk  (object,  rs_object,  rs_bltblk, 
rs_imdope) ; 

break; 

case 

G_PR0GDEF 

: break; 

case 

G.IBOX 

: break; 

case 

G.BUTTON 

: fix_string  (object,  rs_object,  rs_strlngs); 
break; 

case 

G_B0XCHAR 

: break; 

case 

G.STRING 

: fix_strlng  (object,  rs.object,  rs_strlngs); 
break; 

case 

G.FTEXT 

: fix_tedinfo  (object,  rs_object,  rs_tedlnfo, 
rs.strings) ; 

break; 

case 

G_FB0XTEXT 

: fix_tedlnfo  (object,  rs_object,  rs_tedinfo, 
rs.strings) ; 

break; 

case 

G_IC0N 

: fix_iconblk  (object,  rs_object,  rs_iconblk, 
rs_imdope,  rs_strings); 

break; 

case 

G.TITLE 

: fix_string  (object,  rs_object,  rs_strings); 
break; 

/*  switch  */ 

for  (object  = 0;  object  < n_frstr;  object++) 
rs_frstr  [object]  = (LONG)rs_strings  [rs_frstr  [object]]; 


for  (object  = 0;  object  < n_frlmg;  object++) 

fix_frlmg  (object,  rs_frlmg,  rs_bitblk,  rs_imdope); 
j /*  rsc.create  */ 
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Statt  rsrc_load  kann  dann  rsc_create  aufgerufen  werden,  wobei  die  Resourcen  im  Pro- 
grammcode  fest  verankert  sind.  Dies  ist  bei  Venvendung  von  Accessories  ratsam. 


2.6  Accessories 

Accessories  sind  GEM-Programme,  die  beim  Starten  des  GEM  geladen  werden  und  dann 
permanent  im  Speicher  bleiben.  Sie  laufen  im  Hintergrund  einer  Applikation  ab.  Beispie- 
le  fiir  Accessories  sind:  Druckerspooler,  Rechner,  Uhr,  Kontrollfeld  usw.  Im  Gegensatz 
zu  einer  Applikation  kann  man  Accessories  nie  beenden.  Sie  miissen  also  in  einer  Endlos- 
schleife  auf  Nachrichten  vom  Bildschirmmanager  warten  und  diese  dann  ausfiihren. 

Beispiel: 
while  (TRUE) 

event  = evnt_mesag  (msg_buf) ; 

] /*  while  */ 

Der  einzige  Unterschied  zu  „normalen“  GEM-Applikationen  besteht  darin,  daB  sie  direkt 
iiber  den  Meniipunkt  „Desk“  links  oben  (GEM  l.X)  bzw.  iiber  den  Menupunkt  des 
Namens  der  Hauptapplikation  (ab  GEM  2.X),  der  sich  rechts  oben  in  der  Meniizeile 
befmdet,  aufgerufen  werden  konnen. 


Accessories  konnen  unter  GEM  l.X  allerdings  keine  Meniileiste  haben.  Dies  ist  ein  gra- 
vierender  Nachteil.  Aus  diesem  Grand  wurde  im  Windowmanager  der  Beispielapplika- 
tion  SCRAP  ermoglicht,  Meniizeilen  innerhalb  eines  GEM-Fensters  zu  verwalten.  Diese 
Meniizeilen  werden  ebenfalls  mit  dem  RCS  erstellt. 

Ab  GEM  2.X  konnen  Accessories  den  AES-Aufraf  menu_bar  tatigen  und  eine  eigene 
Meniileiste  installieren.  Jedesmal,  wenn  ein  Fenster  des  Accessories  nach  oben  kommt, 
andert  der  Bildschirmmanager  die  Meniizeile  auf  die  des  Accessories.  Kommt  ein  Fenster 
der  laufenden  Applikation  hoch,  schaltet  er  wieder  auf  die  Meniizeile  der  Applikation  um. 


2.7  Formate 

In  diesem  Kapitel  werden  die  3 wichtigen  GEM-Formate  erlautert.  Es  handelt  sich  um 
Metadateien  (.GEM),  Bit-Image-Dateien  (.IMG)  und  um  Ausgabedateien  (.OUT).  Gera- 
de  diese  drei  Dateien  ermoglichen  es,  Datenaustausch  zwischen  beliebigen  Programmen 
vorzunehmen. 
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2.7.1  Metadatei-Format 


Metadateien  sind  nichts  anderes  als  abgespeicherte  VDI-Befehle,  die  in  objektorientierten 
Zeichenprogrammen  wie  GEMDRAW  benutzt  warden,  Im  Abschnitt  2.3  wurde  genau 
erlautert,  wie  das  VDl  aufgerufen  wird:  Durch  die  Bindings  werden  die  Felder  contrl, 
initin,  ptsin  gefiillt  und  dann  das  VDI  direkt  aufgerufen.  Diese  drei  Felder  beschreiben 
einen  VDI  Befehl  vollstandig. 

Im  Feld  contrl  [0]  steht  die  Funktionsnummer,  in  contrl  [1]  die  Anzahl  der  Punkte  (z.B. 
bei  v_pline),  in  contrl  [3]  die  Anzahl  der  Integer-Werte  (z.B.  bei  vst_point)  und  in 
contrl  [5]  steht  der  sogenannte  Subcode,  falls  es  sich  um  grafische  Grundfunktionen 
(Funktionsnummer  11)  oder  um  ESC-Funktionen  (Funktionsnummer  5)  handelt. 

Je  nach  Wert  der  Felder  contrl  [1]  und  contrl  [3]  folgen  in  einer  Metadatei  die  Koordina- 
tenpunkte  im  Feld  ptsin  und/oder  die  ganzzahligen  Werte  im  Feld  intin.  Ein  Kommando 
besteht  also  mindestens  aus  den  contrl-Elementen  und,  wenn  ndtig,  aus  ptsin-  und  initin- 
Elementen. 


Eine  Vorbemerkung  sei  an  dieser  Stelle  gegeben:  Metadateien  liegen  immer  im  INTEL- 
Format  (low-high)  vor.  Mochte  man  in  einem  68000-System  Metadateien  einlesen,  so 
mufi  in  jedem  Wort  das  nieder-  und  hoherwertige  Byte  vertauscht  werden, 

Eine  Metadatei  beginnt  mit  einem  Kopf,  der  die  Charakteristika  der  in  ihr  enthaltenen 
Grafik  beschreibt.  Nach  dem  Kopf  kommen  18  VDI-Grundeinstellungen,  die  beim  Off- 
nen  einer  Metadatei  (v_opnwk)  automatisch  geschrieben  werden.  Ab  Befehl  19  begin- 
nen  die  eigenen  VDI-Aufrufe.  Der  Kopf  einer  Metadatei  hat  in  C folgende  Struktur: 


typedef  struct  meta^header 


WORD 

id; 

WORD 

headlen; 

WORD 

version; 

WORD 

transform; 

WORD 

min_x; 

WORD 

min_y; 

WORD 

max..x; 

WORD 

max_y; 

WORD 

pwidth; 

WORD 

pheight; 

WORD 

ll_x; 

WORD 

11-y; 

WORD 

ur_x; 

WORD 

ur_y; 

WORD 

bit„ image; 

META. 

.HEADER; 

2.  7 Formate 
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Wird  eine  Grafik  auf  einem  beliebigen  Computer  erstellt,  so  mufi  man  angeben,  wo  der 
Nullpunkt  der  Grafik  zu  finden  ist.  Dieser  berechnet  sich  aus  den  Werten  lower-left-x 
(ll_x),  lower-left-y  (ll_y),  upper-right-x  (ur_x)  und  upper-right-y  (ur_y).  Man  sagt, 
dab  diese  Werte  das  Koordinatensystem  einer  Metadatei  beschreiben.  Die  Applikation 
GEMDRAW  legt  z.B.  den  Mittelpunkt  einer  Grafik  auf  die  Mitte  einer  Seite,  so  dafi  auch 
negative  Koordinatenpunkte  (am  linken  Rand  einer  Seite)  auftreten  konnen. 

Um  zu  bestimmen,  wie  groft  ein  Pixel  in  einer  Metdatei  sein  soil,  mufi  die  SeitengroBe 
(pwidth  und  pheight)  angegeben  werden.  Ist  das  Koordinatensystem  z.B.  ICKXlx  1000 
Punkte  groB  und  hat  die  Seite  10  X 10  mm,  so  ist  ein  Pixel  1/100  mm  groB.  Die  Seiten- 
groBe wird  in  1/10  mm  angegeben.  Eine  SeitengroBe  von  19.05  X 25.4  cm  (7.5  X 10  Zoll) 
wird  dann  durch  pwidth  = 1905  und  pheight  = 2540  beschrieben. 

Eine  Metadatei  fangt  immer  mit  —1  an,  id  hat  also  den  Wert  OxFFFF.  Das  zweite  Wort 
gibt  die  Lange  des  Kopfes  an  (headlen).  Addiert  man  zum  Dateianfang  die  headlen,  so 
kommt  man  auf  den  ersten  VDI-Befehl. 

Der  Wert  von  Version  hangt  davon  ab,  mit  welchem  GEM-System  die  Metadatei  erstellt 
wurde.  Meist  ist  der  Wert  101  (Version  1.1)  oder  301  (Version  3.1)  ab  GEM-Version 
3.11.  Die  Version  wird  durch  die  Formel  1(K)  * Hauptversionsnummer  + Nebenversions- 
nummer  beschrieben. 

Der  Wert  transform  legt  fest,  ob  das  NDC  oder  RC-Koordinatensystem  benutzt  werden 
soil.  Die  Angabe  bezieht  sich  aber  nur  auf  die  Orientierung  der  Y-Werte.  Im  NDC- 
System  sind  positive  Y-Werte  am  oberen  Bildrand,  im  RC-System  am  unteren  Bildrand. 
Wie  groB  letztendlich  die  X-  und  Y-Werte  sein  konnen,  hangt  nur  vom  Koordinaten- 
system ab  (ll_x,  ll_y,  ur_x,  ur_y). 

Damit  ein  Grafikprogramm  schnell  bestimmen  kann,  ob  die  Grafik,  die  in  einer  Metadatei 
dargestellt  ist,  in  ein  vorgegebenes  Rechteck  paBt,  kann  es  die  Werte  min_x,  min_y, 
max_^x  und  max_y  benutzen.  Es  gibt  die  maximale  Ausdehnung  der  Grafik  im  benutz- 
ten  Koordinatensystem  an. 

Beispiel:  Stellen  wir  uns  einen  Bildschirm  mit  1000  X 500  Punkten  vor  und  zeichnen  eine 
Linie  vom  Punkt  100,200  zu  Punkt  300,100.  Die  Ausdehnung  dieser  Grafik  betragt  dann: 

min_x  — 100; 
min_y  = 100; 
max_x  = 300; 
max_y  = 2(X); 

Im  Programm  VDITEST  in  Kapitel  2.3  wurden  diese  Werte  fUr  das  gezeichnete  Haus 
berechnet.  Dort  wurde  auch  gezeigt,  wie  man  eine  Metadatei  erstellt. 

Am  Ende  des  Kopfes  befmdet  sich  noch  das  sogenanne  Flag  bit_image.  Es  gibt  an,  ob 
sich  eine  Bit-Imgage-Datei  in  der  Metadatei  befmdet.  In  der  Realitat  befindet  sich  in 
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keiner  Metadatei  eine  Pixelgrafik.  Zeichnet  man  ein  Bild  namens  TEST  in  GEMPAINT, 
so  erstellt  es  auBer  der  Datei  TEST. IMG  noch  die  Datei  TEST. GEM.  In  letzterer  befindet 
sich  genau  ein  VDI-Befehl:  v_bit_image.  Im  Kopf  ist  dann  der  Wert  bit_image  auf  1 
gesetzt, 

Im  folgenden  wird  das  Programm  DUMPGEM  vorgestellt.  Es  listet  zu  jeder  Metadatei 
den  Kopf  und  alle  darin  befindlichen  VDI-Befehle  im  Klartext  auf.  Es  berucksichtigt  alle 
Funktionen  bis  GEM  3.11  einschlieBlich  Bezier-Funktionen  und  die  intemen  Funktionen, 
die  von  GEMDRAW  benutzt  werden.  Zum  Verstandnis  von  Metadateien  sollten  Sie  sich 
alle  auf  der  Begleitdiskette  befindliche  Dateien  mit  Suffix  „.GEM“  mit  diesem  Programm 
ansehen.  Achten  Sie  dann  besonders  auf  die  Befehlsfolge  ab  Befehl  Nummer  19. 


# include  <stdio.h> 

# include  <portab.h> 

# include  <string.h> 

#if  GEMDOS 
# Include  <osbind.h> 
#else 

# include  <gerados.h> 

# Include  <dosbind.h> 
#endif 


# define 

MAX_MLEN 

65535L  /* 

max  metafile  length 

# define 

MAX.VDI 

200 

/* 

vdi  functions 

*/ 

# define 

MAX_ESC 

200 

/* 

escape  functions 

*/ 

# define 

MAX_GDP 

20 

/* 

drawing  primitives 

# define 

MAX„VWM 

200 

/* 

v_wrlte_meta  sub functions  */ 

# define 

MAX.BEZ 

20 

/* 

max  bezler  list 

*/ 

#define 

0P_ESC 

5 

# define 

0P_BEZ 

6 

#define 

OP.BEZFILL  9 

#define 

0P_GDP 

11 

/* 

watch  for  v_bez_on/off 

*/ 

#define 

BEZ.SUB 

13 

/* 

subcode  for  bezier  functions  */ 

^define 

VWM^SUBCODE  99 

/* 

subcode  for  v_wrlte^meta 

*/ 

#deflne 

V_SETRGBI 

18500 

/* 

subcode  for  v_setrgbi  */ 

#define 

V.TOPBOT 

18501 

/* 

subcode  for  v^topbot  */ 

/***»*»  Typen  ifx******************##*************************#*)!*** / 

typedef  struct  metaheader 

WOEtD  id; 

WORD  headlen; 
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WORD  version; 

WORD  transform; 

WORD  mln_x; 

WORD  mln_y; 

WORD  max_x; 

WORD  max_y; 

WORD  pwidth; 

WORD  pheight; 

WORD  ll_x; 

WORD  ll_y; 

WORD  ur_x; 

WORD  ur_y; 

WORD  bit_ image; 

) METAHEADER; 

Variablen  / 


LOCAL  WORD 
LOCAL  WORD 
LOCAL  WORD 
LOCAL  WORD 
LOCAL  WORD 


contrl  [12]; 
intin  [256]; 
ptsin  [256]; 
n_pts; 
n_int; 


LOCAL 

LOCAL 

LOCAL 

LOCAL 

LOCAL 

LOCAL 


BYTE  namebuf fer  [32767] ; 

BYTE  meta_name  [80]; 

ULONG  meta_len; 

DWORD  meta_ index; 

DWORD  *meta_buffer; 

METAHEADER  *meta_header; 


LOCAL 

LOCAL 

LOCAL 

LOCAL 

LOCAL 

LOCAL 

LOCAL 

LOCAL 


BYTE  *vdi_list  [MAX_VDI] ; 

BYTE  »esc_list  [MAX_ESC] ; 

BYTE  »gdp_list  [MAX_GDP] ; 

BYTE  *vwm_list  [MAX_VWM] ; 

BYTE  »bez_list  [MAX_BEZ]; 

BYTE  ^undefined  = "undefined"; 

BYTE  »vwra_text  = 

"v_write_meta  (vdi_handle,  nunuints,  ints,  num_pts,  pts)"; 
BYTE  »ndc_rc  [3]  = ("NDC",  "reserved",  "RC"); 


/*»»»»*  Prototypen  »**»»»**»»»**»»**»»»***»»»»*»»»»*»»»»»****»»*»*» / 


LOCAL  BOOLEAN  file.exist 
LOCAL  VOID  strupper 
LOCAL  VOID  flip.word 
LOCAL  BOOLEAN  get.list 


.((BYTE  ^filename)); 
.((BYTE  »s)); 

.((BYTE  »adr)); 
-((VOID)); 
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LOCAL  BOOLEAN  read_meta 
LOCAL  VOID  show_header 
LOCAL  WORD  get_word 
LOCAL  BOOLEAN  get_code 
LOCAL  BYTE  *get_command 
LOCAL  VOID  show_meta 


_((BYTE  *raeta_name) ) ; 
-((VOID)); 

-((VOID)); 

_((VOID)); 

-((VOID)); 

-((VOID)); 


LOCAL  BOOLEAN  file_exlst  (filename) 
BYTE  ^filename; 


#lf  GEMDOS 

return- (Fsflrst  (filename,  0x00)  ==  0); 
#else 

return  (Fsfirst  (filename,  0x00)  > 0); 
#endlf 

) /*  flle_exist  */ 

LOCAL  VOID  strupper  (s) 

BYTE  »s; 


{ 

while  (*s) 

[ 

if  (»s  >=  'a')  »s  8c=  OxDF; 

S++; 

j /*  while  */ 

] /*  strupper  */ 

LOCAL  VOID  flip_word  (adr) 

BYTE  »adr; 

{ BYTE  c; 


c = adr  [0]; 
adr  [0]  = adr  [1]; 
adr  [1]  = c; 

] /*  flip_word  */ 
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LOCAL  BOOLEAN  get_llst  () 

( 

FILE  *fp; 

BYTE  »funcname; 

BYTE  s [255] ; 

WORD  1,  intliuO; 

WORD  opcode,  subcode; 

BOOLEAN  ok; 


fp  = fopen  ("DUMPGEM.DAT",  "r"); 


if  (fp  ==  NULL) 

( 

prlntf  ("DUMPGEM.DAT  not  foundXn"); 
ok  = FALSE; 

] /»  if  */ 
else 


for  (i  = 0; 
for  (i  = 0; 
for  (i  = 0; 
for  (1  = 0; 
for  (1=0; 


i < MAX_VDI; 
1 < MAX_ESC; 
1 < MAX_GDP; 
1 < MAX_VWM; 
i < MAX_BEZ; 


i++)  vdl_list 
i++)  esc_list 

1-H-)  gdp_list 
1++)  vwnullst 
i++)  bez.llst 


[i] 

[i] 

[i] 

[1] 

[1] 


undefined; 

undefined; 

undefined; 

vwm_text; 

undefined; 


funcname  = namebuffer; 


while  (fgets  (s,  255,  fp)  !=  NULL) 

[ 

if  (»s  !=  V) 

{ 

sscanf  (s,  "!^d,",  &opcode); 
sscanf  (s  + 4,  &subcode); 

sscanf  (s  + 10,  "y{d,",  &lntin_0); 
strcpy  (funcname,  s + 15); 

funcname  [strlen  (funcname)  - 1]  = EOS;  /*  cut  off  \n  */ 


if  (opcode  ==  0P_ESC  1 1 
opcode  ==  0P_GDP  1 1 
opcode  ==  0P_BEZ  1 1 
opcode  ==  OP_BEZFILL) 

{ 

switch  (opcode) 

( 
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case  OP.ESC  : if  (subcode  ==  V_SETRGBI) 
subcode  = 1 

if  (subcode  ==  V.TOPBOT) 
subcode  = 151; 


case  OP.GDP 


case  0P_BEZ 


case  0P_BEZFILL  : 


) /*  switch  */ 

] /*  if  */ 
else 

vdLlist  [opcode]  = 
j /»  if  »/ 


if  (subcode  ==  VWILSUBCODE) 
vwm_list  [intin_0]  = funcname; 
else 

esc.list  [subcode]  = funcname; 
break; 

if  (subcode  ==  BEZ_SUB) 

I 

if  (intin_0  ==  O)  /*  v_bez_off  */ 
gdp_list  [MAX_GDP  — 1]  = funcname; 
else  /*  v_bez_on  */ 

gdp_list  [MAX_GDP  - 2]  = funcname; 
j /*  if  */ 
else 

gdp_list  [subcode]  = funcname; 
break; 

if  (subcode  ==  BEZ.SUB) 

bez_list  [opcode]  = funcname; 
else 

vdi_list  [opcode]  = funcname; 
break; 

if  (subcode  ==  BEZ_SUB) 

bez_list  [opcode]  = funcname; 
else 

vdi_list  [opcode]  = funcname; 
break; 


funcname;  /*  no  special  case  */ 


funcname  +=  strlen  (funcname)  + 1; 
] /*  while  »/ 


ok  = TRUE; 
j /*  if  */ 

return  (ok); 

] /*  get_list  */ 
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LOCAL  BOOLEAN  read_raeta  (meta_name) 
BYTE  »meta_name; 


[ 

WORD  handle; 
WORD  i; 


meta.len  = MAX_MLEN; 

raeta_buffer  = (DWORD  *)Malloc  (meta_len); 


if  (meta_buffer  !=  NULL) 

[ 

if  (file.exist  (meta_name) ) 

I 

handle  = Fopen  (meta_name,  0); 

meta_len  = Fread  (handle,  meta_len,  raeta_buf fer) ; 


#if  GEMDOS 

for  (i  = 0;  1 < meta_len  / 2;  i++) 
flip.word  ((BYTE  *)&meta_buffer  [i]); 

#endif 

meta_header  = (METAHEADER  »)meta_buffer; 
meta_ index  = raeta_header->headlen; 


Fclose  (handle) ; 
return  (TRUE) ; 
j /*  if  »/ 
else 
{ 

printf  ("?s  not  foundXn",  meta_name); 
return  (FALSE); 

] /*  else  */ 

) /»  if  »/ 
else 
[ 

printf  ("Not  enough  memory  to  allocate  bufferXn"); 
return  (FALSE); 

) /*  else  */ 

] /*  read_meta  */ 
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LOCAL  VOID  show_header  () 

[ printf  ("\nMetaflle:  !fs\n\n",  meta_name); 

printf  ("metafile  id  : )66d\n",  meta_header->id) ; 

printf  ("header  length  : ?6d\n",  meta_header->headlen) ; 

printf  ("GEM  version  : ?4d.^d\n", 

meta_header-> vers ion  / 100,  meta_header-> vers ion  % 100); 
printf  ("NDC/RC  flag  : !?6s\n", 

ndc_rc  [meta_header->transform] ) ; 
printf  ("extent  min  x : i66d\n",  meta_header->min_x) ; 

printf  ("extent  min  y : i66d\n",  meta_header->min_y) ; 

printf  ("extent  max  x : ?6d\n",  meta_header->max_x) ; 

printf  ("extent  max  y : ?6d\n",  meta_header->max_y) ; 

printf  O'page  width  : ^3d.!K02d  cm\n", 

meta_header->pwidth  / 100,  meta_header->pwldth  % 100); 
printf  ("page  height  : ?3d.iK02d  cm\n", 

meta_header->phelght  / 100,  meta_header->pheight  % 100) ; 
printf  ("window  lower  left  x : !56d\n",  meta_header->ll_x) ; 

printf  ("window  lower  left  y : Jf6d\n",  meta_header->ll_y) ; 

printf  ("window  upper  right  x : ^6d\n",  meta_header->ur_x) ; 

printf  ("window  upper  right  y : !f6d\n",  meta_header->ur_y) ; 

printf  ("bit  image  opcode  flag  : $6d\n",  meta_header->b it_ image ) ; 
printf  0'\n\n"); 

) /»  show.header  */ 

LOCAL  WORD  get.word  () 

{ 

if  (meta_index  > meta_len)  return  (-1); 
return  (meta_buffer  [meta_index++] ) ; 

] /*  get_word  */ 

LOCAL  BOOLEAN  get_code  () 

( 

WORD  i; 

contrl  [0]  = get_word  (); 

if  (contrl  [0]  ==  -1)  return  (FALSE); 
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contrl  [1]  = get_word  (); 

contrl  [3]  = get_word  (); 

contrl  [5]  = get.word  (); 

n_pts  = contrl  [1]  * 2; 
n_int  = contrl  [3] ; 

for  (1=0;  1 < n_pts;  i++)  ptsin  [i]  = get_word  (); 
for  (1=0;  1 < n_lnt;  1++)  Intln  [1]  = get_word  (); 

return  (TRUE); 

) /*  get_code  */ 

LOCAL  BYTE  *get_corara8Uid  () 

( 

BYTE  ^command; 

WORD  opcode; 

WORD  subcode; 

opcode  = contrl  [0] ; 
subcode  = contrl  [5]; 

If  (opcode  ==  OP.ESC  1 I 
opcode  ==  0P_GDP  1 1 
opcode  ==  0P_BEZ  1 I 
opcode  ==  0P_BEZFILL) 


switch  (opcode) 
f 

1 

case  0P_ESC 

: If  (subcode  ==  V.SETRGBI)  subcode  = 150; 

If  (subcode  ==  V_T0PB0T)  subcode  = 151; 

If  (subcode  ==  VWM.SUBCODE) 

command  = vwm_llst  [Intln  [0]]; 

else 

command  = esc_llst  [subcode] ; 
break; 

case  0P_GDP 

: If  (subcode  ==  BEZ.SUB) 

1 

If  (contrl  [1]  ==  0)  /»  v_bez_off  */ 
command  = gdp_llst  [MAX_GDP  - 1] ; 
else  /»  v_bez_on  */ 

command  = gdp.llst  [MAX_GDP  - 2]; 
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n_pts  = 0; 

] /»  if  */ 
else 

command  = gdp_list  [subcode] ; 
break; 

case  0P_BEZ  : if  (subcode  ==  BEZ_SUB) 

command  = bez_list  [opcode]; 
else 

command  = vdi.llst  [opcode]; 
break; 

case  0P_BEZFILL  : if  (subcode  ==  BEZ.SUB) 

command  = bez_list  [opcode] ; 
else 

command  = vdLlist  [opcode]; 
break; 

) /»  switch  */ 

] /*  if  */ 
else 

command  = vdLlist  [opcode] ; /*  no  special  case  */ 

return  (command); 
j /*  get_comraand  */ 

LOCAL  VOID  show_meta  () 


{ 

WORD  count; 

WORD  i; 

BYTE  ^command; 

count  = 0; 

while  (get_code  ()) 

[ 

count++; 

command  = get_command  ( ) ; 

printf  ("***»*  Command  #%d  »»***\n\n",  count); 
printf  ("^s\n",  command); 

printf  ("contrl  [0]:  !{d\n",  contrl  [0]); 
printf  ("contrl  [1]:  /5d\n",  contrl  [1]); 
printf  ("contrl  [3]:  i?d\n",  contrl  [31)  > 
printf  ("contrl  [5]:  ifd\n",  contrl  [5]); 
printf  ("\n"); 
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if  (n_pts  > 0) 

for  (1=0;  1 < n_pts;  i +=  2) 

I 

prlntf  ("ptsin  [!Kd]  = x = ?d\n",  1,  ptsin  [i]); 
printf  ("ptsin  [5fd]  = y = !fd\n",  1 + 1,  ptsin  [i  + 1]); 

] /*  for  »/ 
printf  ("\n"); 

) /*  if  */ 

if  (n_int  > 0) 

[ 

for  (1=0;  i < n_int;  i++) 
printf  ("intin  [?d]  = il!d\n",  i,  Intin  [i]); 
printf  ("\n"); 

] /*  if  »/ 

printf  ("\n"); 
j /*  while  */ 

] /*  show_meta  */ 

/»*»»*  *»»*»»»*»»**»  X »*»»***  ***»»»**  IHHHHHHHHHHHHHf  *»»»»»*»»  / 

GLOBAL  WORD  main  (argc,  argv) 

WORD  argc; BYTE  »argv  []; 


if  (argc  < 2) 

( 

printf  ("Dump  which  metafile  (without  suffix  .GEM):  "); 
gets  (meta_name); 
j /*  if  */ 
else 

strcpy  (meta_narae,  argv  [1]); 

if  (*raeta_name) 

{ 

strupper  (meta.name); 
strcat  (meta_narae,  ".GEM"); 

if  (get_list  0 &&  read_raeta  (meta.name)) 

( 

show_header  ( ) ; 
show_meta  ( ) ; 
j /*  if  */ 

] /*  if  »/ 
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return  (0); 
) /*  main  */ 


Beim  Start  des  Programmes  DUMPGEM  muB  sich  die  Datei  DUMPGEM.DAT  im  glei- 
chen  Ordner  befinden  wie  DUMPGEM. PRG  bzw.  DUMPGEM.EXE.  In  der  Datei 
DUMPGEM.DAT  befinden  sich  alle  VDI-Befehle  bis  GEM-Version  3.11.  Sie  kann  fiir 
spatere  GEM-Versionen  einfach  mit  einem  Texteditor  erweitert  werden. 


— Erweiterungen  fur  Metadateien 

Im  folgenden  sollen  2 Erweiterungen  fur  Metadateien  besprochen  werden,  die  von  einer 
Applikation  aus  in  eine  Metadatei  hineingeschrieben  werden  konnen  und  Zusatzinforma- 
tionen  beinhalten.  Dazu  benutzen  wir  die  Mdglichkeit,  eigene  selbstdefmierte  Subop- 
codes, die  ab  101  beginnen  miissen,  in  die  Metadatei  hineinzuschreiben.  Halten  sich  alle 
Softwarehersteller  an  die  Vereinbarung,  wird  der  Datenaustausch  wesentlich  erleichtert. 

Diese  Zusatzinformationen,  die  in  eine  Metadatei  geschrieben  werden  sollen,  sind 
folgende: 

1 . Der  Name  und  die  Versionsnummer  der  Applikation,  die  die  Metadatei  erstellt  hat. 

2.  Die  Farbtabelle  fur  die  Farbindizes. 

Die  Vorteile  sind  klar:  Kennt  man  die  Versionsnummer  und  den  Namen  der  Applikation, 
die  die  Metadatei  erstellt  hat,  so  kann  man  selbst  bestimmen,  ob  man  mit  der  Metadatei 
etwas  anfangen  will.  Die  Versionsnummer  kann  hilfreich  sein,  wenn  Informationen  in 
alteren  Metadateien  nicht  mehr  in  neueren  Applikationen  unterstiitzt  werden. 

Die  Farbtabelle  gibt  an,  wie  die  Farben  auf  dem  Gerat,  auf  dem  die  Metadatei  erstellt 
wurde,  eingestellt  waren.  Auf  einem  Rechner  konnte  man  z.B.  eine  Grafik  mit  16  Grau- 
stufen  erstellen.  Liest  man  die  Grafik  z.B.  in  ein  Desktop-Publishing-System  ein,  so  er- 
scheint  sie  kunterbunt.  Deshalb  gibt  man  die  RGB-Werte  jeder  Farbe  an  und  schreibt  sie 
in  die  Metadatei. 

Fiir  Name  und  Versionsnummer  benotigen  wir  einen  neuen  Subopcode.  Der  neue  Subop- 
code fiir  die  Funktion  v_write_meta,  der  im  Feld  intin  [0]  angegeben  wird,  lautet  also: 

# define  VM_VER_APP  101 

a)  Version  und  Applikation 

Das  sogenannte  „Binding“  der  neuen  Funktion  lautet: 
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GLOBAL  VOID  vm_ver_app  (vdi_handle,  version,  app_narae) 
WORD  vdl_handle,  version; 

UBYTE  »app_name; 


WORD  i; 


contrl 

contrl 

contrl 

contrl 

contrl 


[0] 

= 5; 

[1] 

= 0; 

[3] 

= 2 + 

strlen  ( app_name ) ; 

[5] 

= 99; 

/»  v_write_meta  */ 

[6] 

= vdi. 

.handle; 

intin  [0]  = VM_VER_APP; 
intin  [1]  = version; 


i = 2; 

while  ((intin  [i++]  = (WORD) (UBYTE)*app_name++)  !=  0); 
vdi  0; 

) /*  vm_ver_app  */ 


Beispiel:  Die  Versionsnummer  1.32  (GEM-Format  = 100  * Hauptversionsnummer  + 
Nebenversionsnummer)  und  der  Name  der  Applikation  (z.B.  GEMDRAW)  soil  in  die 
Metadatei  geschrieben  werden. 

WORD  version; 

BYTE  app_name  [80] ; 

version  = 132; 

strcpy  (app_name,  "GEMDRAW"); 

vm_ver_app  (vdi_handle,  version,  app.name); 

Achtung!  Der  Name  der  Applikation  muB  immer  ohne  Suffix  angegeben  werden,  da  sie 
sich  auf  dem  ATARI  ST  und  unter  MS-DOS  unterscheiden  (z.B.  TEST.PRG, 
TEST.APP). 

b)  Farbtabelle 

Mit  dem  VDl-Befehl  vs_color  kann  zu  jedem  Farbindex  eine  neue  Farbmischung  aus 
Rot-,  Griin-  und  Blauwerten  defmiert  werden.  Ebenso  kann  die  aktuelle  Farbmischung 
eines  Farbindexes  mittels  vq_color  ausgelesen  werden. 

Beispiel;  Aus  einer  laufenden  Applikation  heraus  sollen  die  aktuellen  Farbmischungen 
der  Farbindizes  in  die  Metadatei  geschrieben  werden.  Jeder  RGB-Wert  liegt  im  Zahlenbe- 
reich  0 — 1000,  wie  dies  bei  der  Benutzung  von  vq_color  im  VDI  definiert  ist. 
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WORD  colors; 

WORD  rgb  [3]; 

screen_handle  = open-work  (SCREEN);  /*  siehe  SHOWGEM.C  »/ 
colors  = work_out  [13] j 

raeta_handle  = open.work  (METAFILE) ; 

for  (i  = 0;  i < colors;  i++) 

vq_color  (screen.handle,  1,  FALSE,  rgb); 
vs_color  (meta_handle,  i,  rgb); 

} /*  for  */ 

Ein  letztes  Wort  zu  Metadateien;  Im  Kopf  befindet  sich  die  Angabe  der  Seitenbreite  und 
Seitenhohe  (pwidth  und  pheight).  Mochte  man  Metadateien  erstellen,  so  wird  man  diesen 
beiden  Werten  Standardgrdfien  geben.  Folgende  StandardgroBen  werden  von  den  meisten 
GEM-Programmen  (z.B.  GEM  OUTPUT  3.11)  unterstutzt; 


Bezeichnung 

Zoll 

Zentimeter 

Letter 

8,50  * 11,00 

21,59  * 27,94 

Legal 

8,50  * 14,00 

21,59  * 35,56 

Half 

8,50  * 5,50 

21,59  * 13,97 

Ledger 

11,00  * 17,00 

27,94  + 43,18 

Din  A3 

11,69  * 16,54 

29,70  * 42,00 

Din  A4 

8,07  * 11,69 

21,00  * 29,70 

Din  A5 

5,85  * 8,27 

14,85  * 21,00 

Din  B5 

7,17  * 9,84 

18,20  * 25,00 

Wide 

14,00  * 11,00 

35,56  * 27,94 

Die  pwidth-  und  pheight-Werte  ergeben  sich  aus  den  Zentimeter- Werten  multipliziert  mit 

100. 


2.7.2  Bit-Image-Format 

Pixelgrafiken,  im  Gegensatz  zu  objektorientierten  Vektorgrafiken,  werden  im  GEM- 
System  in  einem  Standardformat  abgelegt.  Dieses  Standardformat  nennt  man  Bit-Image- 
Format.  Es  stellt  eine  komprimierte  Speicherung  von  Raster-  oder  Pixelbildern  dar.  Da- 
teien,  die  solch  eine  Rastergrafik  enthalten,  haben  itnmer  das  Suffix  „.IMG“. 

Hauptsachlich  gibt  es  2 Vorteile,  Pixelgrafiken  im  GEM-Standardformat  abzuspeichern. 
Zum  einen  kann  mit  dem  VDI-Befehl  v_bit_  image  die  komplette  Grafik  auf  einen 
Drucker  oder  auch  eine  Kamera  ausgegeben  werden.  Zum  anderen  konnen  Pixelgrafiken 
zwischen  verschiedenen  Programmen  ausgetauscht  werden.  Die  Applikation  WORD- 
PLUS,  die  zu  ihren  Anfangszeiten  noch  ein  eigenes  Grafikformat  benutzte,  hat  jetzt  um- 
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geschwenkt  auf  das  GEM-Bit-Image-Format.  Alle  Anwender  von  GEM-Software  auf 
dem  ATARI  ST  wiirden  es  auBerdem  begriiBen,  wenn  die  Grafikdaten  endlich  zwischen 
verschiedenen  Applikationen  austauschbar  waren. 

Bevor  der  Aufbau  einer  IMG-Datei  beschrieben  wird,  wollen  w'ir  uns  iiber  die  Zukunft 
Gedanken  machen.  Als  das  GEM-System  1984  herauskam,  hatte  ein  PC  mit  EGA-Karte 
eine  Auflbsung  von  640x350  Punkten  und  16  gleichzeitig  darstellbaren  Farben.  5 Jahre 
spater  erreichten  Grafikkarten  Auflbsungen  von  1280x960  Punkten  oder  16  Millionen 
Farben  gleichzeitig.  Das  Bit-Image-Format  ist  zwar  so  allgemein  gehalten,  daB  es  beliebi- 
ge  Auflbsungen  und  Farbenpracht  darstellen  kann,  hat  aber  einen  Nachteil. 

Man  kann  aus  einer  IMG-Datei  nicht  herauslesen,  wie  die  aktuelle  Farbeinstellung  war, 
als  das  Bild  erzeugt  wurde.  Wer  kann  schon  sagen,  welche  Farbe  der  Farbindex  183  hatte, 
als  ein  Bild  mit  256  Farben  digitalisiert  abgespeichert  wurde.  War  es  eine  Graustufe  Oder 
eine  andere  Farbe? 

Glucklicherweise  ist  die  Struktur  einer  Bit-Image-Datei  so  flexibel,  daB  beliebig  viele  Zu- 
satzinformationen  vor  die  reinen  Pixeldaten  geschrieben  werden  kbnnen.  Der  Kopf  einer 
IMG-Datei  wird  von  uns  jetzt  um  die  fehlenden  Informationen  erweitert  und  zwar  so, 
daB  das  Format  fur  alle  Zeiten  gerustet  ist.  Das  neue  Format  bleibt  mit  dem  alten  kompati- 
bel  und  wird  rechnerunabhangig  gestaltet. 

Bevor  wir  auf  das  neue  Format  eingehen,  miissen  wir  verstehen,  wie  Farben  abgelegt 
werden  kbnnen.  Dazu  machen  wir  eine  kleine  Exkursion  in  die  Technik  der  Farbmodelle. 

Zur  Zeit  existieren  3 wichtige  Farbmodelle  sowie  ein  Farbsystem: 

a)  RGB-Modell 

b)  CMY-Modell 

c)  HLS-Modell 

d)  Pantone  Farbsystem 

a)  Das  RGB  (Rot-Griin-Blau)  Modell  kennt  fast  jeder,  denn  die  meisten  Softwareent- 
wickler  kbnnen  entweder  auf  einen  Farbmonitor  oder  einen  Farbfernseher  zuriickgreifen. 
Farben  werden  in  diesem  Modell  additiv  dargestellt.  Jede  Farbe  stellt  sich  aus  den  3 An- 
teilen  Rot,  Griin  und  Blau  zusammen.  Nahert  man  sich  mit  einer  Lupe  einem  Farbbild- 
schirm,  so  kann  man  die  Schlitze  dieser  drei  Farben  erkennen. 

Wenn  wir  annehmen,  daB  die  Einzelwerte  einer  Farbkomponente  (R,G,B)  im  Bereich  0 
bis  1 liegen,  so  ergibt  sich  Schwarz  zu  (0,0,0)  und  WeiB  zu  (1,1,1).  Griin  hat  dann  den 
Wert  (0,1,0).  Alle  Farben  sind  mit  diesen  3 Werten  darstellbar.  Wieviele  Farbtbne  man 
auf  einem  Computersystem  tatsachlich  darstellen  kann,  hangt  davon  ab,  wieviele  Werte 
eine  Einzelkomponente  annehmen  kann.  Hat  man  z.B.  16  Werte  pro  Komponente,  so  er- 
geben  sich 


16  X 16  X 16  = 4096 
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verschiedene  Farbtone.  Die  Gesamtheit  dieser  Tone  nennt  man  auch  die  Farbpalette. 
Wieviel  Farbtone  letztlich  auf  einem  Bildschirm  dargestellt  werden  kbnnen,  hangt  von 
der  Anzahl  der  Bits  ab,  die  pro  Bildschirmpunkt  reserviert  werden.  Diese  Zahl  nennt  man 
Anzahl  der  Farbebenen  (planes).  Benutzt  man  z.B.  4 Bits  pro  Bildschirmpunkt,  so  erge- 
ben  sich  16  verschiedene  Farben,  die  sich  gleichzeitig  darstellen  lassen.  Diese  Farben 
lassen  sich  dann  meist  aus  der  o.g.  Farbpalette  frei  wahlen.  So  konnte  man  dann  ein 
Schwarzweifibild  mit  16  Graustufen  darstellen. 

Im  GEM-System  hat  man  sich  dafiir  entschieden,  RGB-Werte  von  0 — KXK)  pro  Farbton 
zuzulassen.  Damit  ergaben  sich 

1000x1000x1000  = 1000000000  = I Milliarde 

Farbtone.  Diese  Anzahl  kann  das  menschliche  Auge  nicht  mehr  unterscheiden,  die  Auf- 
losung  ist  also  ausreichend  fur  alle  Zeiten.  Schwarz  hat  einen  RGB-Wert  von  (0,0,0)  und 
WeiB  einen  Wert  von  (1000, 1000,  KXK)). 

b)  Das  CMY-Modell  benutzt  die  Komplementarfarben  des  RGB-Modells.  Diese  sind 
Cyan  (Turkis),  Yellow  (Gelb)  und  Magenta  (Violett).  Zwei  Farben  sind  komplementar 
zueinander,  wenn  das  Zusammenmischen  die  Farbe  WeiB  ergibt.  So  sind  Cyan  und  Rot 
Komplementarfarben.  Ein  Gegenstand  im  Licht,  der  in  der  Farbe  Cyan  erscheint,  absor- 
biert  rot.  Daher  riihrt  auch  der  Name  des  subtraktiven  Farbmodells. 

c)  Das  HLS-Modell  wird  bei  Macintosh-Software  haufig  benutzt  und  erhalt  seinen  Na- 
men  dutch  die  drei  Begriffe  Hue  (Tonung),  Lightness  (Helligkeit)  und  Saturation  (Satti- 
gung).  Jede  Farbe  kann  dutch  die  Angabe  einer  WinkelgroBe  und  der  Prozentzahlen  fiir 
Helligkeit  und  Sattigung  bestimmt  werden.  Rot  liegt  z.B.  bei  Winkel  120,  Griin  bei  220. 
Wir  wollen  hier  nicht  naher  darauf  eingehen,  sondern  nur  die  Existenz  dieses  Modells 
festhalten. 

d)  Da  Farben  auf  Bildschirmen,  Druckern  und  Belichtungsanlagen  immer  verschieden 
herauskommen,  existiert  in  den  USA  das  sogenannte  Pantone  Farbsystem.  Dieses  sind 
vordefinierte  Farbpaletten.  Zur  Zeit  kann  man  aus  etwa  1000  Farbtonen  wahlen.  Auch 
darauf  soil  hier  nicht  naher  eingegangen  werden. 

Nachdem  wir  nun  wissen,  wie  die  Farben  in  einem  Farbbild  aufgebaut  werden  konnen, 
widmen  wir  uns  der  IMG-Datei.  Sie  besteht  aus  einem  Kopf  und  den  reinen  Pixeldaten. 
Der  Kopf,  wie  er  von  Digital  Research  definiert  ist,  lautet  in  C-Schreibweise: 

typedef  struct  lmg_header 

[ 

WORD  version; 

WORD  headlen; 

WORD  planes; 

WORD  pat_run; 

WORD  pix_width; 
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WORD  pix_height; 
WORD  sLwidth; 
WORD  Sl_height; 

] IMG_HEADER; 


Achtung!  In  einer  Bit-Image-Datei  liegt  der  Header  immer  im  Motorola  68000-Format 
vor.  Auf  INTEL-Rechnern  (MS-DOS,  FLEXOS)  mulJ  er  also  byteweise  gedreht  werden. 


version 

headlen 

planes 

pat_run 

pix_width 

pix_height 

sLwidth 

sLheight 


Eine  Versionsnummer,  meist  1 
Lange  des  Kopfes  in  1 6-Bit- Worten  (hier  8) 
Anzahl  der  Farbebenen,  die  die  Grafik  enthalt 
Anzahl  Bytes  fiir  einen  „pattern  run",  (s.u.) 
Pixelbreite  des  Quellgerates  in  1/1000  mm 
Pixelhohe  des  Quellgerates  in  1/1000  mm 
Breite  einer  „Scan-Zeile“  in  Pixel 
Hohe  einer  „Scan-Zeile“  in  Pixel 


Mochte  man  eine  Bit-Image-Datei  erstellen,  so  kann  man  einige  Werte,  die  man  in  den 
Kopf  eintragen  muB,  leicht  bestimmen.  Addiert  man  den  Wert  headlen  zum  Anfang  der 
Datei,  so  kommt  man  zu  den  reinen  Pixeldaten.  Die  Anzahl  der  Farbebenen  erhalt  man 
uber  die  VDl-Funktion  vq  extnd  (work_out  [4]).  Der  „pattern  run"  ist  bei  alien  Bild- 
schirmen  2,  wobei  die  Werte  pix_width  und  pix_height  aus  der  Funktion  v_opnvwk 
(work_out  [3]  - [4])  bestimmt  werden  kbnnen.  Die  Breite  einer  Scan-Zeile  ist  immer 
ein  Vielfaches  von  16.  Bei  einer  Grafik  mit  20  Pixel  in  horizontaler  und  10  Pixel  in  verti- 
kaler  Richtung  miissen  die  beiden  sl-Werte  wie  folgt  gesetzt  werden; 


sLwidth  = 32; 
sLheight  = 10; 


Ab  der  relativen  Dateiposition  „headlen  * 2“  beginnen  die  Pixeldaten  einer  Bit-Image- 
Datei.  Sie  sind  komprimiert  abgelegt,  aber  recht  einfach  wieder  zu  entpacken. 


Eine  komprimierte  Grafik  besteht  aus  sogenannten  Scan-Zeilen.  Sie  geben  die  Pixelhohe 
der  Grafik  an.  Jeder  Scan-Zeile  geht  ein  Wiederholungsfaktor  (VRC  = vertical  replica- 
tion count)  voraus,  der  angibt,  wie  oft  diese  Scan-Zeile  wiederholt  werden  soil.  Sind  also 
n Zeilen  einer  Grafik  gleich,  so  ist  der  Wiederholungsfaktor  gleich  n. 


Um  den  Wiederholungsfaktor  zu  erkennen,  wird  er  durch  zwei  0-Bytes  sowie  dem  Wert 
255  (hexadezimal  = OxFF)  eingeleitet,  also: 


Byte  Wert 

0 0 

1 0 

2 OxFF 

3 VRC 
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AnschlieBend  folgen  die  komprimierten  Daten  der  Pixel.  Dabei  werden  nacheinander  alle 
Farbebenen  beschrieben.  Zuerst  kommen  also  die  Daten  einer  Scan-Zeile  fiir  Ebene  1, 
dann  fiir  Ebene  2 usw.  Die  Anzahl  der  Farbebenen,  die  in  der  Grafik  benutzt  werden, 
kann  aus  dem  Kopf  (planes)  abgelesen  werden. 

Um  eine  Scan-Zeile  giinstig  zu  packen,  werden  3 Methoden  verwendet.  Sie  werden  „solid 
run“,  „pattern  run"  und  „bit  string"  genannt. 

a)  solid  run 

Wie  der  Name  schon  sagt,  werden  hiermit  einfarbig  gefiillte  Flachen  beschrieben.  Ein 
solid  run  besteht  aus  einem  einzigen  Byte,  wobei  das  hochste  Bit  angibt,  ob  der  Punkt 
gesetzt  ist  oder  nicht.  Die  unteren  sieben  Bit  werden  fiir  die  Lange  L des  run  benutzt. 
Pro  solid  run  werden  8 * L Punkte  beschrieben. 

Beispiel: 

81;  Linie  mit  8 gesetzten  Punkten 
8A:  Linie  mit  80  gesetzten  Punkten 
08:  Linie  mit  64  nicht  gesetzten  Punkten 

b)  pattern  run 

Der  pattern  run  dient  zur  Beschreibung  von  regelmaBigen  Mustern.  Diese  Muster  wieder- 
holen  sich  auf  Bildschirmgrafiken  haufig  alle  16  Bit,  so  daB  in  diesem  Fall  die  Lange  des 
Musters  aus  2 Bytes  besteht.  Der  Wert  pat_run  im  Kopf  der  Datei  gibt  an,  aus  wievie- 
len  Bytes  ein  Muster  besteht. 

Der  pattern  run  beginnt  mit  dem  Wert  0,  ihm  folgen  die  Anzahl  der  Musterwiederholun- 
gen  (n)  und  die  Musterbeschreibung  (meist  2 Bytes): 


Byte  Wert 

0 0 

1 n 

2 erstes  Byte  des  Musters 


pat_run  + 1 letztes  Byte  des  Musters 


Beispiel:  Folgendes  Muster  soil  sich  5-mal  wiederholen: 


” (2-mal  4 Punkte  und  4 Leerzeichen) 


Es  wird  dann  komprimiert  zu  den  vier  Bytes:  00  05  FO  FO 
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c)  bit  string 

In  den  Fallen,  wo  kein  solid  run  oder  kein  pattern  run  angewendet  werden  kann,  werden 
die  Bits  direkt  gespeichert.  Bin  bit  string  hat  folgendes  Aussehen: 


Byte  Wert 

0 0x80 

1 n 

2 erstes  Byte 


n+1  letztes  Byte 


Beispiel:  Folgendes  Muster  soil  als  bit  string  kodiert  werden: 

Die  Bytefolge  sieht  dann  so  aus:  80  02  D7  3F 

Die  Reihenfolge  des  Dekodierens  ist  wichtig,  da  sonst  die  Methoden  des  Packens  nicht 
erkannt  werden.  Pixeldaten  mtissen  also  z.B.  wie  folgt  dekodiert  werden  (Algorithmus): 

1 . Ist  Byte  = 0,  dann  schaue  auf  Byte  + 1 . 

Ist  Byte  +1=0, 

dann  vertical  replication  count, 
sonst  pattern  run. 

2.  Ist  Byte  = 0x80,  so  bit  string. 

3.  Keine  der  obigen  Falle,  dann  solid  run. 

Achtung:  Der  Wert  sl_ width  (Breite  einer  Scan-Zeile  in  Pixels)  kann  bis  zu  7 Bit  klei- 
ner  sein,  als  die  Daten,  die  eine  Scan-Zeile  beschreibt,  da  Scan-Zeilen  byteweise  be- 
schrieben  werden  (siehe  auch  Algorithmus  in  SHOWGEM.C).  Ist  z.B.  sl_ width  = 1, 
so  werden  trotzdem  8 Bit  pro  Scan-Zeile  beschrieben,  also  7 Bit  zuviel.  Erzeugt  man  eine 
Grafik  mit  GEMPAINT,  so  ist  der  Wert  sl_width  immer  eine  durch  16  teilbare  Zahl. 
Hier  werden  also  immer  mindestens  16  Bit  beschrieben,  auch  wenn  nur  ein  einziges  Pixel 
(das  am  weitestens  links  stehende)  gesetzt  ist.  AuDerdem  erzeugt  GEMPAINT  zu  jeder 
IMG-Datei  eine  zugehorige  Datei  mit  Suffix  „.GEM“.  Sie  enthalt  Zusatzinformationen, 
wie  GroDe  der  Seite  und  Ausdehnung  der  darin  enthaltenen  Grafik  und  den  Dateinamen 
der  Image-Datei.  Schauen  Sie  sich  die  entsprechenden  Dateien  mit  DUMPGEM  einmal 
genauer  an. 

Zum  Schlufi  noch  ein  allgemeines  Wort  iiber  die  Datendarstellung.  Wie  man  an  obigen 
Beispielen  sieht,  werden  die  einzelnen  Bits  immer  im  Standardformat  abgelegt.  D.h. , daB 
das  hbchstwertige  Bit  immer  den  am  weitesten  links  stehenden  Punkt  beschreibt.  Auf  der 
Beispieldiskette  befindet  sich  die  Datei  TIGER. IMG  und  COLORS. IMG.  Ersteres  ist  ein 
monochromes  Bild,  letzteres  eine  Grafik  mit  16  Farben,  also  4 Farbebenen. 
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— Das  neue  Bit-Image-Format 

Im  neuen  Format  ist  es  unser  Ziel,  auch  die  Farbtabelle  (RGB-Werte  pro  Farbindex)  im 
Kopf  unterzubringen.  Der  RGB-Wert  jeder  Farbe  soil  dabei  gerateunabhangig  beschrie- 
ben  werden.  Wir  nennen  die  Beschreibungsmdglichkeiten  gemaB  dem  VDI  auch  Stan- 
dardformat. 


Gehen  wir  von  einem  bestimmten  Grafikformat  aus,  so  interessiert  noch,  wieviele  Werte 
jede  einzelne  Farbe  auf  dem  Quellgerat  maximal  annehmen  konnte.  Bei  einem  ATARI 
ST  ist  diese  Zahl  z.B.  8,  da  jeder  RGB-Wert  acht  unterschiedliche  Einstellungen  anneh- 
men kann.  Aus  diesem  Wert  kann  man  auch  den  Wert  fur  die  Standardeinstellung  bestim- 
men.  VDI-Standardeinstellungen  liegen  im  Bereich  von  0 bis  1000.  Fur  8 unterschied- 
liche RGB-Werte  heiBt  dies: 


Spezifisch  Standard 


0 

1 

2 

3 

4 

5 

6 
7 


0 

142 

285 

428 

571 

714 

857 

1000 


Um  die  Farbtabelle  darzustellen,  benutzen  wir  fiir  jeden  Eintrag  einen  48-Bit-Wert,  der 
die  RGB-Werte  beschreibt.  D.h.,  daB  ffir  jede  Farbkomponente  Einstellungen  von  0 — 
65535  vorgenommen  werden  konnen.  Daraus  ergibt  sich  der  Bereich,  aus  denen  die  Far- 
ben  gewahlt  werden  konnen  zu: 


2^16  * 2*16  * 2*16  = 2*48 

Die  ergibt  etwa  eine  Auswahl  aus  300  Billionen  verschiedener  Farben.  Da  es  sich  bei 
diesen  Werten  um  RGB-  oder  CMY-Werte  oder  andere  Werte  handeln  kann,  legen  wir 
das  Farbmodell  ebenfalls  im  erweiterten  Kopf  ab.  Der  Wert  color_model  kann  0 
(RGB),  1 (CYM),  2 (HLS)  oder  3 (Pantone)  sein.  Im  Fall  „Pantone“  beschreibt  der  Rot- 
Wert  die  Pantone-Farbe. 


Falls  Digital  Research  den  Kopf  erweitern  sollte,  setzen  wir  noch  einen  Erkennungswert 
(x_id)  fiir  unseren  erweiterten  Kopf  an  die  erste  Stelle  hinter  dem  alten  Kopf.  Dieser 
Wert  soil  die  Zeichenkette  „XIMG“  enthalten. 


Damit  wird  die  Beschreibung  des  erweiterten  Kopfes  (XIMG_HEADER)  wie  folgt  fest 
gelegt: 
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# define  RGB  0 

# define  CYM  1 

# define  HLS  2 

# define  PANTONE  3 

typedef  stinict 

( 

UWORD  red; 

UWORD  green; 
UWORD  blue; 
j RGB.LIST; 


typedef  struct  ximg_header 


WORD  version; 

WORD  headlen; 

WORD  planes; 

WORD  pat_run; 

WORD  pix_width; 

WORD  pix_height; 

WORD  sl_width; 

WORD  sl_height; 

BYTE  x_ld  [4] ; 

WORD  color.model;  /*  0 = RGB,1  = CYM,2  = HLS, 3 = Pantone  */ 

RGB_LIST  color_table[] ; /*  open  array,  length  2^planes  */ 

] XIMG_HEADER; 

Der  gesamte  Kopf  liegt  natiirlich  im  68000-Format  vor,  d.h.  auf  INTEL-Rechner  mu6 
er  wort-  bzw.  langwortweise  gedreht  werden.  Das  Drehen  von  Wortem  und  Langwortem 
wurde  weiter  oben  im  Programm  GRC  (flip_long,  flip_word)  gezeigt. 

Zum  erweiterten  Kopf  ein  Beispiel:  Auf  einem  Rechner  wurde  eine  Pixelgrafik  der  Grofie 
32  X 20  Pixel  erstellt.  Der  Bildschirm  konnte  16  Farben  (4  Farbebenen)  aus  einer  Palette 
von  512  (8  Stufen  pro  RGB-Wert)  gleichzeitig  darstellen.  Es  wurde  das  RGB-Modell  ge- 
w^lt.  Der  erweiterte  Kopf  muB  dann  wie  folgt  aussehen; 

# define  COLORS  16;  /»  16  = 2^planes  */ 


RGB.LIST  rgb.list  [COLORS] ; 
XIMG_HEADER  x_header; 


x_header . vers ion 
x_header . headlen 
x_header. planes 
x_header . pat_run 
x_header . p ix_w idth 
x_header . p ix_he Ight 


= 1; 

= sizeof  (XIMG_HEADER)  + sizeof  (rgb_list); 
= 4; 


= 2; 

= work_out  [3] ; /*  nach  opnvwk  */ 
= work_out  [4] ; 
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x_header.sl_width  = 32; 

x_header.sl_helght  = 20; 

strcpy  (x_ld,  "XIMG"); 
x_header . color_model  = RGB; 


Das  Feld  rgb_list  wurde  vorher  naturlich  mit  den  entsprechenden  Werten  gefullt.  Der 
Kopf  und  die  Farbtabelle  kann  nun  nach  eventuellem  Drehen  der  Daten  auf  eine  Datei 
geschrieben  werden: 


#if  18068 
flip_word 
fllp.word 
fllp_word 
flip_word 
fllp_word 
flip_word 
flip_word 
flip_word 
flip.word 


((BYTE  *) &x_header. version) ; 
((BYTE  *)&x_header.headlen) ; 

( ( BYTE  * ) 8tx_header . planes ) ; 
((BYTE  *)8cx_header.pat_run) ; 
((BYTE  *)&x_header.pix_wldth) ; 

( ( BYTE  * ) &x_header . p ix_he ight ) ; 
((BYTE  *)&x_header.sl_wldth) ; 
((BYTE  *)&x_header.sl_helght) ; 
((BYTE  »)8cX_header.color_model) ; 


for  (1  = 0;  i < COLORS;  1++) 

[ 

flip.word  ((BYTE  »)&rgb_list  [i].red); 
flip.word  ((BYTE  *)&rgb_list  [i]. green); 
flip.word  ((BYTE  »)&rgb_list  [i].blue); 

) /*  for  */ 

#endif 


handle  = Fcreate  ("GRAFIK.IMG",  0); 

Fwrite  (handle,  (LONG)sizeof  (XIMG.HEADER) , &x_header) ; 

Fwrite  (handle,  (LONG)sizeof  (rgb.list),  rgb.list); 

. . . jetzt  gepackte  Grafikdaten  schreiben. . . 

Fclose  (handle); 

Entsprechend  kann  die  Bit-Image-Datei  wieder  eingelesen  werden  (Programmfragment): 

XIMG.HEDAER  *x_header; 

UBYTE  ^buffer; 

LONG  size; 

WORD  i,  colors; 

handle  = Fopen  ("GRAFIK.IMG",  0); 

size  = Fseek  (OL,  handle,  2);  /*  Dateigrofie  */ 

buffer  = Malloc  (size); 

Fread  (handle,  size,  buffer); 
x.header  = (XIMG.HEADER  ») buffer; 
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#if  18086 

flip...  (Kopf  drehen,  siehe  oben) 

#endif 

colors  - 2 « x_header->planes;  /*  2''planes  */ 

/*  Farbtabelle  auf  Bildschlrm  ausgeben  */ 
for  (1=0;  1 < colors;  1++) 

printf  C’rgb  [552d]  = %3d,%3d,%3i\n" , 

x_header->color_table  [i].red, 
x_header->color_table  [1]. green, 
x_header->color_table  [i] .blue) ; 


2.7,3  OUT-Dateiformat 

Wie  bei  der  Funktion  v_alpha_text  in  Kapitel  2.3.7  beschrieben,  konnen  Steuerzeichen 
fur  Textattribute  in  eine  Datei  mit  Suffix  „.OUT“  geschrieben  werden.  Der  entsprechen- 
de  Ausgabetreiber  (z.B.  fiir  den  Drucker)  erkennt  diese  Steuerzeichen  und  schaltet  das 
Ausgabegerat  in  den  entsprechenden  Modus  um. 


Sollen  Textdaten  mit  Attributen  (fett,  kursiv,  etc.)  zwischen  verschiedenen  Applikationen 
ausgetauscht  werden,  so  empfehlen  wir  das  von  Digital  Research  standardisierte  OUT- 
Dateiformat. 

Es  ist  eine  ASCII-Datei,  die  zum  Umschalten  zwischen  Textattributen  den  Steuercode 
DC2  (ASCII-Wert  18)  benutzt.  Danch  folgt  ein  Buchstabe,  der  das  Ein-  Oder  Ausschalten 
des  Attributes  beschreibt. 


(DC2)0 

(DC2)1 

(DC2)2 

(DC2)3 

(DC2)4 

(DC2)5 

(DC2)6 

(DC2)7 

(DC2)8 

(DC2)9 

(DC2)A 

(DC2)B 

(DC2)C 

(DC2)D 

(DC2)E 


Fettschrift  ein 
Fettschrift  aus 
Kursivschrift  ein 
Kursivschrift  aus 
Unterstreichen  ein 
Unterstreichen  aus 
Superscript  ein 
Superscript  aus 
Subscript  ein 
Subscript  aus 
NLQ-Schrift  ein 
NLQ-Schrift  aus 
Breitschrift  ein 
Breitschrift  aus 
Hellschrift  ein 


208 


2 GEM  und  sein  Umfeld 


(DC2)F  — Hellschrift  aus 
(DC2)G  — (DC2)V  — reserviert 
(DC2)W  - Pica  ein 
(DC2)X  - Elite  ein 
(DC2)Y  — Schmalschrift  ein 
(DC2)Z  — Proportionalschrift  ein 

Der  Text  „Dies  ist  fett  bzw.  kursiv."  rniiUte  dann  so  aussehen: 

Dies  ist  (DC2)0fett(DC2)  1 bzw.  (DC2)2kursiv(DC2)3. 

AuBerdem  besteht  die  Moglichkeit,  Grafiken  mit  in  die  Ausgabedatei  einzubinden.  Dabei 
wird  eine  Einleitungssequenz  von  2 Escape-Zeichen  benutzt.  Die  Zeile  ist  wie  folgt  auf- 
gebaut: 

(ESC)(ESC)GEM,x,y,w,h, D:\PATHNAME\FILENAME.EXT 

Die  Werte  x,  y,  w und  h geben  ein  Rechteck  relativ  zur  aktuellen  Cursorposition  des  Aus- 
gabegerates  an.  Die  Einheit  wird  in  Zeichenzellen  angegeben.  „D;“  ist  der  Laufwerks- 
name,  auf  dem  sich  die  Grafik  befindet.  Das  Bild  TEST. IMG  auf  Laufwerk  C im  Ordner 
\GEMAPPS\IMAGES,  das  sich  2 Zeichen  rechts  und  1 Zeile  unter  dem  Text  „Hier  ist 
das  Bild“  befindet  und  60  Zeichen  breit  sowie  10  Zeilen  hoch  sein  soil,  muB  wie  folgt 
kodiert  werden: 

Hier  ist  das  Bild(CR)(LF) 

(CR)(LF) 

(ESC)(ESC)GEM,2,0,60,10,C:\GEMAPPS\IMAGES\TEST.IMG(CR)(LF) 

Der  Druckertreiber  versteht  diese  Sequenzen  und  gibt  das  gewunschte  Ergebnis  auf  dem 
Ausgabegerat  aus. 
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Als  Verfechter  cler  „sauberen“  Programmierung  konnen  wir  nur  alien  Lesern  dieses 
Buches  raten,  sich  am  Programmierstil  der  vorgestellten  Programme  ein  Beispiel  zu  neh- 
men.  Wir  legen  den  allergroBten  Wert  auf  Portabilitat.  Den  Preis,  den  man  dafiir  bezahlen 
muB,  ist  auBerst  gering:  Lediglich  ein  paar  Programmzeilen  mehr  mussen  geschrieben 
werden  (siehe  VDITEST,  GRC,  RCM).  Mit  einigen  „defmes“  der  Form 

#if  GEMDOS  , 

#endlf 

kann  der  gleiche  Quelltext  auf  alien  Rechnern  iibersetzt  werden. 

Das  in  Kapitel  6 vorgestellte  Programm  SCRAP  ist  bis  heute  das  einzige  Programm,  das 
sich  auf  jedem  GEM-System  ohne  Fehler  und  Modifikationen  ubersetzen  laBt  und  pro- 
blemlos  der  Umgebung  anpaBt. 

Eine  traurige  Ausnahme  bildet  allerdings  das  Programm  SHOWGEM  auf  der  beiliegen- 
den  Diskette.  Unter  FlexOS  und  X/GEM  werden  VDI-Aufrufe  leider  nicht  mehr  iiber 
die  contrl-,  intin-  und  ptsin-Felder  getatigt.  Um  Metadateien  auszugeben,  bedarf  es  eines 
Interpreters,  der  aus  den  Informationen  in  den  o.g.  Feldern  „echte“  VDI-Aufrufe  macht. 
Da  wir  bisher  keine  Zeit  fiir  solch  einen  Interpreter  hatten,  muB  der  interessierte  Leser 
diesen  selbst  bauen.  Alle  Informationen  iiber  Metadateien  wurden  ja  in  den  vorangegan- 
genen  Kapiteln  dargelegt,  so  daB  die  Aufgabe  nicht  alizu  schwer  fallen  diirfte, 

a)  Portabilitat 

Einige  werden  sich  fragen : „Wozu  Portabilitat"?  Dies  ist  richtig,  wenn  man  nur  auf  einen 
Rechner  und  auf  ein  Betriebssystem  fixiert  ist.  Spatestens  dann,  wenn  es  ums  Vermarkten 
von  Applikationen  geht,  sieht  die  Sache  anders  aus.  Stellen  Sie  sich  vor,  Sie  schreiben 
eine  tolle  Tabellenkalkulation  auf  dem  ATARI  ST  und  mochten  diese  vertreiben.  Sie  mer- 
ken  aber,  daB  noch  mehr  Kunden  daran  interessiert  sind,  die  nicht  aus  ATARI-Kreisen 
stammen;  z.B.  fehlen  unter  X/GEM  noch  sehr  viele  GEM-Applikationen,  da  noch  nichts 
angepaBt  wurde.  Wenn  Sie  jetzt  Ihre  Applikation  mit  den  Hilfsmitteln  aus  diesem  Buch 
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geschrieben  haben,  so  konnen  Sie  am  gleichen  Tag,  an  dem  die  Programmierung  auf  dem 
ATARI  ST  abgeschlossen  ist,  z.B.  bei  Siemens  anrufen  und  dort  Ihre  Applikation  fur 
X/GEM  verkaufen.  Lediglich  ein  Ubersetzungslauf  von  einigen  Minuten  ist  notig. 

Portabilitat  ist  aber  nicht  nur  auf  verschiedene  Rechner  und  Betriebssysteme  fixiert,  son- 
dern  ist  ebenso  wichtig  fur  eine  bestimmte  GEM-Version.  Applikationen,  die  auf  GEM 
l.X  laufen,  konnen  ohne  Probleme  auf  neueren  Versionen  ausgefiihrt  werden. 

Wenn  vorhin  von  „sauberer“  Programmierung  gesprochen  wurde,  so  ist  damit  auch  ge- 
meint,  dafi  keine  hardwareabhangigen  Funktionen  benutzt  werden  sollten.  Versucht  man 
Z.B.,  ein  Programm  fur  ATARI  ST  auf  einem  GroBbildschirm  mit  1280  x 960  Punkten 
laufen  zu  lassen,  so  erlebt  man  fast  nur  Programmabstiirze.  Fiir  den  ATARI  TT  gilt  das 
gleiche.  Einige  werden  zwar  jetzt  behaupten,  daB  dadurch  die  Performance  verloren  gin- 
ge,  aber  das  ist  bei  den  meisten  Programmen  nicht  so  wichtig.  Wenn  einem  Softwareent- 
wickler  dies  dennoch  wichtig  erscheint,  so  soli  er  den  Algorithmus  zunachst  in  der  Spra- 
che  C formulieren  und  einbinden.  Lauft  er,  so  sollte  er  aus  Portabilitatsgriinden  gesichert 
werden.  AnschlieBend  kann  er  den  Algorithmus  in  Assembler  schreiben  und  optimieren. 
So  bleibt  er  portabel  fiir  andere  Betriebssysteme  oder  andere  Hardware,  und  das  Pro- 
gramm lauft  trotzdem  schnell. 

Portabilitat  bezieht  sich  auch  auf  die  verwendeten  Compiler.  So  benutzt  der  Lattice  C- 
Compiler  als  int-Werte  immer  32  Bit.  Auch  werden  immer  32  Bit  fiir  jeden  Parameter 
auf  den  Stack  geschrieben.  Hier  empfiehlt  sich  die  Verwendung  eigener  Datentypen.  So 
konnte  ein  16-Bit- Wort  fur  Lattice  und  andere  Compiler  wie  folgt  beschrieben  werden: 

#if  LATTICE 
# define  WORD  short 
#else 

# define  WORD  int 
#endif 

Die  16-Bit-Variable  i kann  dann  als 
WORD  i; 

beschrieben  werden.  Programme  werden  also  portabel  bezuglich  der  verwendeten  Da- 
tentypen. 

Portabilitat  bezuglich  der  VDI-  und  AES-Funktionen  ist  ebenfalls  ein  Thema  fiir  sich. 
Wahrend  unter  MS-DOS  die  Quellen  der  sogenannten  Bindings  aller  Funktionen  im 
GEM-Programmer’s-Toolkit  mitgeliefert  werden,  sind  Entwickler  auf  einem  ATARI  ST 
von  den  Compilerherstellern  abhangig.  Dort  werden  zum  Compiler  nur  die  fertigen  VDI- 
und  AES-Libraries  mitgeliefert.  Diese  entsprechen  leider  nicht  immer  der  Namensge- 
bung  aus  dem  Original-Toolkit  von  Digital  Research.  So  wird  die  AES-Funktion 
graf_mbox  haufig  falsch  als  graf_movebox  in  die  AES-Library  gepackt.  Die  Funktion 
graf_movebox  aber  existiert  nicht  unter  MS-DOS,  Programme  sind  also  nicht  mehr 
portabel. 
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So  kann  man  wieder  zu  einem  Trick  greifen.  Z.B.  wird  fur  TURBO  C auf  dem  ATARI 
ST  die  Funktion  wie  folgt  umdefmiert: 

#lf  GEMDOS 
#if  TURBO.C 

♦define  graf_mbox  graf_raovebox 

♦endif 

♦endif 

Der  Programmierer  schreibt  in  sein  Progamm  immer  graf_mbox  und  der  Praprozessor 
des  benutzten  Compilers  ersetzt  diese  Funktion  durch  den  Aufruf  graf_movebox,  was 
wiederum  dem  Linker  gelallt,  da  er  diese  Funktion  jetzt  aus  der  (falschen)  AES-Library 
holen  kann. 

b)  ANSI-Standard 

Neuere  Compiler  werden  nach  der  ANSI-Norm  entwickelt.  Durch  die  neue  ANSI-Norm 
ergeben  sich  in  C-Programmen  neue  Moglichkeiten,  und  es  werden  Fehler  verhindert. 
Das  groBte  Manko  an  C war  bisher,  dafi  keine  Typiiberpriifung  der  Parameter  bei  Funk- 
tionen  getatigt  wurde.  Dies  hatte  zur  Folge,  dafi  auf  Parameter  innerhalb  einer  Funktion 
falsch  zugegriffen  wurde,  wenn  ein  anderer  Datentyp  ubergeben  wurde.  Beispiel: 

♦include  <stdio.h> 

♦include  <portab.h> 

GLOBAL  WORD  main  () 


LONG  s; 

s = summe  (1,  2); 

printf  ("Summe:  J»ld\n",  s); 

return  (0); 

] /*  main  */ 

LOCAL  LONG  summe  (a,  b) 

LONG  a,  b; 


return  (a  + b); 
j summe  /»summe*/ 
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Die  Funktion  Summe  soli  die  Summe  zweier  LONG-Werte  berechnen  und  zuriickliefern. 
Das  obige  Programm  wird  nicht  korrekt  laufen,  da  die  beiden  iibergebenen  Zahlen  vom 
Compiler  als  16-Bit-Integer-Wert  (int)  interpretiert  werden.  So  werden  zwei  16-Bit- 
Werte  iibergeben,  wobei  die  Funktion  Summe  aber  auf  32-Bit-(LONG)-Werte  zugreift. 

Man  hatte  dies  verhindern  konnen,  indem  man  die  Summe  wie  folgt  berechnet  hatte: 

s = summe  (IL,  2L);  oder 
S = summe  ((LONG)l,  (L0NG)2); 

Im  ersten  Fall  werden  die  beiden  Zahlen  1 und  2 als  Langwerte  iibergeben  (Suffix  L). 
Im  zweiten  Fall  werden  die  beiden  Zahlen  durch  die  sogenannte  Cast-Operation  auf  den 
Datentyp  LONG  umgewandelt. 

Aber  da  Menschen  Fehler  machen,  passiert  es  haufig,  dall  man  an  eine  Funktion  falsche 
Datentypen  iibergibt.  Was  in  Pascal  und  Modula  schon  lange  geht,  sollte  auch  in  ANSI- 
Compilern  mbglich  sein.  Dort  werden  die  iibergebenen  Datentypen  nicht  nur  gepriift, 
sondern  gegebenfalls  automatisch  an  die  Funktion  angepaht.  Auch  Typiiberpriifung  bei 
Zuweisungen  (Typ  der  linken  Seite  = Typ  der  rechten  Seite)  werden  vorgenommen  und 
eine  Warnung  gebracht,  wenn  die  Typen  nicht  iibereinstimmen.  In  unseren  Beispielpro- 
grammen  wird  deswegen  auch  haufig  die  Cast-Operation  angewendet,  um  Warnungen 
des  Compilers  zu  vermeiden. 

Die  Typanpassung  bei  Funktionsaufrufen  kann  aber  nur  vorgenommen  werden,  wenn  die 
Funktion  vorher  bekannt  ist.  Deshalb  ist  man  dazu  iibergegangen,  alle  Funktionen,  die 
in  einem  Modul  vorkommen,  durch  eine  forward-Deklaration  mit  Datentypen  bekannt  zu 
machen.  Das  obige  Beispiel  sieht  dann  so  aus: 

# include  <stdlo.h> 

# include  <portab.h> 

/*ll*lHHHHHHf)t**»**********)Ht*>****lHHt**»lHl/ 

LOCAL  LONG  summe  (LONG  a,  LONG  b)j 

/ UK- umi  XXlHt  X XX  XXIHHI  *****  IHl*  ************  H IHl  / 

GLOBAL  WORD  main  {) 


LONG  s; 

s = summe  (1,  2); 

printf  ("Summe:  ^ld\n",  s); 


return  (0); 
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) /*  main  */ 

LOCAL  LONG  summe  (a,  b) 

LONG  a,  b; 

{ 

return  (a  + b); 
j /*  summe  */ 

/****»**»*»»)nt***»**jt»**int**»»»)nt»**jHHf)nt/ 

Jetzt  weiB  der  Compiler  zur  Ubersetzungszeit,  daB  die  beiden  Parameter  Langwerte  sein 
miissen,  und  paBt  die  beiden  Zahlen  1 und  2 automatisch  an,  die  dann  an  die  Funktion 
iibergeben  werden. 

Was  machen  aber  Entwickler,  die  noch  keinen  ANSI-Compiler  zur  Verfiigung  haben? 
Sie  konnen  das  obige  Programm  so  nicht  mehr  iibersetzen  lassen.  Aber  auch  fur  sie  gibt 
es  einen  Trick.  Dazu  bedienen  wir  uns  der  Moglichkeit  des  Praprozessors,  Worter  oder 
ganze  Ausdriicke  als  „nichts“  zu  defmieren. 

Beispiel:  Das  Wort  CDECL,  das  in  manchen  Compilern  existiert,  soli  entsprechend  ge- 
loscht  werden: 

# if  TURBO.C 
♦define  CDECL  cdecl 
♦ else 

♦define  CDECL 
♦endif 

Die  Funktionsdefmition 

LOCAL  WORD  CDECL  name  (x) 

WORD  x; 


wird  im  Turbo-C-Compiler,  der  das  Wort  cdecl  kennt,  wie  folgt  umgewandelt: 

static  int  cdecl  name  (x) 
int  x; 

[ 

] 
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In  alien  anderen  Compilern  verwandelt  der  Praprozessor  die  Funktionsdefinition  in: 

static  int  name  (x) 

Int  x; 

( 

] 

Das  Wort  cdecl  wurde  durch  die  Leerdefinition  „#  define  CDECL“  sozusagen  wegde- 
finiert. 

Beim  Problem  unserer  Prototypen  hilft  dieser  Trick  genauso.  Dort  verwenden  wir  fiir 
ANSI-Compiler  ein  anderes  Makro  als  fiir  Compiler,  die  den  ANSI-Standard  nicht  ken- 
nen.  Wir  definieren  folgende  Makros: 

#if  MS_C  1 TURBO.C  1 HIGH_C  /*  ANSI  compilers  */ 

# define  ANSI  1 

# define  ^(params)  params  /*  parameter  checking  */ 

#else 

# define  ANSI  0 

# define  _( params)  ()  /*  no  parameter  checking  */ 

#endif 

ANSI-Compiler  sind  Microsoft  C (MS_C),  Turbo  C (TURBO_C)  und  High  C 
(HIGH„C).  Alle  anderen  Compiler  wie  Lattice  C,  Mark  Williams  C usw.  kennen  den 
ANSI-Standard  nicht. 

Jetzt  konnen  wir  Prototypen  von  Funktionen  wie  folgt  definieren: 

LOCAL  LONG  summe  _((LONG  a,  LONG  b)); 

Bei  ANSI-Compilern  werden  durch  die  Makrodefinition  die  beiden  auBeren  Klammern 
sowie  der  Unterstrich  durch  das  Innere  der  auBeren  Klammern  ersetzt,  Der  Praprozessor 
macht  also  daraus: 

static  long  summe  (long  a,  long  b); 

Der  Praprozessor  von  Compilern  ohne  ANSI-Standard  ersetzt  das  Innere  der  auBeren 
Klammern  durch  „nichts“.  Die  Deklaration  sieht  also  wie  folgt  aus: 

static  long  summe  (); 

Diese  Deklaration  entspricht  der  „normalen“  forward-Deklaration  von  Funktionen,  die 
einen  anderen  Wert  als  „int“  zuriickgeben.  Wer  also  seine  Funktionen  mit  den  Prototypen 
wie  oben  gezeigt  definiert,  ist  iiber  alle  Compiler  hinweg  portabel.  ANSI  oder  nicht  spielt 
5dann  keine  Rolle  mehr. 
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Im  folgenden  wird  zu  den  o.g.  Problemen  die  Include-Datei  PORTAB.H  vorgestellt.  Sie 
enthalt  alle  Unterschiede  (sprachliche  und  GEM-spezifische)  der  folgenden  Betriebssyste- 
me,  Prozessoren,  Compiler  und  GEM-Versionen: 


a)  Bertriebssysteme; 

— GEMDOS  (Digital  Research,  auf  ATARI  ST  verwendet) 

— MS-DOS  (Microsoft  auf  IBM-PC’s  und  Kompatiblen) 

- OS/2  (Microsoft  auf  IBM-PC’s  und  Kompatiblen  ab  80286) 

- FlexOS  (Digital  Research,  auf  Siemens  Programmier-Geraten) 

b)  Prozessoren 

- MOTOROLA  (MOTOROLA  Serie;  68000,  68010,  68020,  68030,  68040) 

- INTEL  (INTEL  Serie:  8088,  8086,  80186,  80286,  80386,  80486) 

c)  Compiler 

— Digital  Research  C (Digital  Research  Inc.) 

— LASER  C (Megamax  Inc.) 

- LATTICE  C (Metacomco) 

- MARK  WILLIAMS  C (Mark  Williams  Company) 

— TURBO  C (Borland,  Heimsoeth) 

- MICROSOFT  C (Microsoft) 

- HIGH  C (Metaware  Inc.) 

d)  GEM-Versionen 

— GEM  l.X  (ATARI  ST,  altere  PC-Version) 

- GEM  2.x  (PC,  ATARI  ST-Version  von  ABC-Software) 

- GEM  3.x  (aktuelle  PC-Version  GEM  3.01  und  GEM  3.11) 

— X/GEM  (Multitasking-Version  unter  FlexOS  und  OS/2) 


/*  »/ 

/*  PORTAB.H  */ 

/*  */ 

/*  Use  of  this  file  may  make  your  code  compatible  with  */ 

/*  all  C compilers  listed.  */ 

/*  V 


/*  ENVIRONMENT  x/ 
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#lfndef  __P0RTAB__ 
# define  __PORTAB__ 

# define  GEMDOS 

1 

/*  Digital  Research  GEMDOS 

»/ 

# define  MSDOS 

0 

/*  Microsoft  MS-DOS 

*/ 

# define  0S2 

0 

/*  Microsoft  OS/2 

*/ 

# define  FLEXOS 

0 

/*  Digital  Research  FlexOS 

*/ 

# define  M68000 

1 

/»  Motorola  Processing  Unit 

»/ 

# define  18086 

0 

/*  Intel  Processing  Unit 

# define  DR_C 

0 

/*  Digital  Research  C Compiler  */ 

# define  LASER_C 

0 

/*  Laser  C Compiler 

»/ 

♦define  LATTICE_C 

0 

/*  Lattice  C Compiler 

»/ 

♦define  MW_C 

0 

/*  Mark  Williams  C Compiler 

♦define  TURB0_C 

1 

/*  Turbo  C Compiler 

»/ 

♦define  MS.C 

0 

/*  Microsoft  C Compiler 

*/ 

♦define  HIGH.C 

0 

/*  Metaware  High  C Compiler 

*/ 

♦define  GEMl 

0x0001 

/*  ATARI  GEM  version 

*/ 

♦define  GEM2 

0x0002 

/»  MS-DOS  GEM  2.x  versions 

*/ 

♦define  GEM3 

0x0004 

/*  MS-DOS  GEM/3  version 

*/ 

♦define  XGEM 

♦ifndef  GEM 
♦ if  GEMDOS 

0x0100 

/*  OS/2,  FlexOS  X/GEM  version 

*/ 

♦define  GEM  GEMl 

♦end if  /*  GEMDOS  »/ 

/*  GEMDOS  default  is  GEMl 

»/ 

♦ if  MSDOS 

♦ define  GEM 
♦endif  /*  MSDOS  */ 

GEM3 

/*  MS-DOS  default  is  GEM3 

*/ 

♦ if  0S2 

♦define  GEM 
♦endif  /*  MSDOS  */ 

XGEM 

/*  OS/2  default  is  X/GEM 

*/ 

♦ if  FLEXOS 

♦define  GEM 

XGEM 

/*  FlexOS  default  is  X/GEM 

*/ 

♦endif  /*  FLEXOS  */ 
♦endif  /*  GEM  */ 

/*  STANDARD  TYPE  DEFINITIONS  */ 

/*»»»»**»»»»*»»»»#*#»»»»»»»*»*  JHHHHHUHHHHHt »»»»  X »»»»»**»»»*  jHHUHHHHHHt  / 
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♦ define 

BYTE 

char 

/*  Signed  byte 

*/ 

♦ define 

UBYTE 

unsigned  char 

/*  Dnsigned  byte 

*/ 

♦if  LATTICE.C 
♦define  WORD 

short 

/*  Signed  word  (16  bits) 

♦ define 

DWORD 

unsigned  short 

/*  Dnsigned  word 

*/ 

♦ else 

♦ define 

WORD 

int 

/*  Signed  word  (16  bits) 

♦ define 

DWORD 

unsigned  int 

/*  Dnsigned  word 

♦endif 
♦ define 

LONG 

long 

/*  Signed  long  (32  bits) 

*/ 

♦ define 

DLONG 

unsigned  long 

/*  Dnsigned  long 

♦ define 

BOOLEAN 

WORD 

/*  2 valued  (true/false) 

»/ 

♦ define 

FLOAT 

float 

/*  Single  precision  float 

*/ 

♦ define 

DODBLE 

double 

/*  Double  precision  float 

*/ 

♦ define 

INT 

int 

/*  A machine  dependent  int 

*/ 

♦ define 

DINT 

unsigned  int 

/»  A machine  dependent  ulnt 

*/ 

♦ define 

REG 

register 

/*  Register  variable 

♦ define 

ADTO 

auto 

/*  Local  to  function 

♦ define 

EXTERN 

extern 

/*  External  variable 

♦ define 

LOCAL 

static 

/*  Local  to  module 

♦ define 

MLOCAL 

LOCAL 

/*  Local  to  module 

♦ define 

GLOBAL 

/*  Global  variable 

*/ 

/*  COMPILER  DEPENDENT  DEFINITIONS  »/ 

/*»**»  » iHUHHHHHHHt »» jHHHHHHHHHUHt  *»»»»**»»»»»**»»»***»»****»»»»***  / 


♦if  GEMDOS 
♦ if  DR_C 

/»  GEMDOS  compilers 

♦define  void  WORD 
♦endif  /*  DR_C  »/ 

/*  DR_C  doesn't  know  void 

*/ 

♦ if  USER_C 

♦define  graf_mbox  graf_movebox 

/*  Wrong  GEM  binding 

*/ 

♦define  graf_rubbox  graf_rubberbox 
♦endif  /»  LASER_C  */ 

/*  Wrong  GEM  binding 

♦ if  LATTICE.C 

♦define  graf.mbox  graf.movebox 

/*  Wrong  GEM  binding 

♦define  graf_rubbox  graf_rubberbox 
♦endif  /*  LATTICE_C  */ 

/»  Wrong  GEM  binding 
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#lf  TURBO_C 

# define  graf_mbox  graf_movebox  /*  Wrong  GEM  binding  */ 

# define  graf.rubbox  graf_rubberbox  /*  Wrong  GEM  binding  */ 

#endif  /*  TURBO.C  */ 

#lf  MW_C 

#deflne  VOID  WORD  /»  MW_C  doesn't  know  (void  *)  »/ 

#endlf  /*  MW.C  */ 

#if  LATTICE.C 

#define  ADR(A)  (LONG)A  » 16,  (LONG)A  & OxFFFF 
#else 

#define  ADR(A)  (WORD) ( (LONG) A » 16),  (WORD) ( (LONG)A  & OxFFFF) 

#endlf  /»  UTTICE.C  »/ 

#endlf  /*  GEMDOS  */ 


#if  MSDOS  I 0S2  /*  MS-DOS  or  0S2  compilers  */ 

#define  ADR(A)  (WORD) ( (LONG)A  & OxFFFF),  (WORD) ( (LONG)A  » 16) 

#endlf  /*  MSDOS  */ 

#if  FLEXOS  /*  FlexOS  compilers  »/ 

#define  ADR(A)  (WORD) ( (LONG)A  & OxFFFF),  (WORD) ( (LONG)A  » 16) 

#endif  /»  FLEXOS  */ 

#lf  MS_C  I TURBO.C  1 HIGH.C  /*  ANSI  compilers  »/ 

# define  ANSI  1 

#define  .(params)  params  /*  parameter  checking  */ 

#else 

# define  ANSI  0 

#define  .(params)  ()  /*  no  parameter  checking  */ 

♦define  const 
♦define  volatile 
♦define  size.t  UINT 
♦ endif 


♦if  DR.C  I LASER.C  1 LATTICE.C  1 MW.C  ! HIGH.C 
♦define  cdecl 
♦define  pascal 
♦endif 


♦define  CONST  const 

♦ define  VOUTILE  volatile 

♦define  CDECL  cdecl 

♦define  PASCAL  pascal 
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# define  SIZE_T  size_t 

ttifndef  VOID 
# define  VOID  void 
#endif 

/*  OPERATING  SYSTEM  DEPENDENT  DEFINITIONS  */ 

/^HHt**»**»»*»********»»»*)t********^HHOHt)t********iHHHHHHt******jHHHHt»»/ 


#if  GEMDOS 


# define  FAR 

/*  Far  Pointer 

*/ 

# define  NEAR 

/*  Near  Pointer 

*/ 

#else 

# define  FAR 

far 

/*  Far  Pointer 

♦/ 

define  NEAR 

near 

/*  Near  Pointer 

*/ 

#endif  /*  GEMDOS  */ 

#if  GEM  & GEMl 

#define  appl_bvset(bvdisk,  bvhard) 

^define  appl_yield()  evnt.timer  (0,  0) 

#define  menu_unregister(mid) 

#define  scrp_clear() 

♦tdefine  xgrf_stepcalc(orgw,  orgh,  xc,  yc,  w,  h,  pcx,  pcy,  pent, 
pxstep,  pystep) 

#define  xgrf_2box(xc,  yc,  w,  h,  corners,  ent,  xstep,  ystep,  doubled) 
#endif  /*  GEMl  */ 

#if  GEM  & (GEMl  I XGEM) 

#define  shel_rdef(lpcmd,  Ipdir) 

#define  sheLwdef (Ipcmd,  Ipdir) 

#endif  /*  GEMl  1 XGEM  «/ 

#if  GEM  St  (GEMl  1 GEM2) 

#define  menu_click(cliek,  setit) 

#endlf  /*  GEMl  1 GEM2  */ 

#if  GEM  & (GEM2  I GEM3  1 XGEM) 

#define  fsel_exinput(pipath,  plsel,  pbutton,  plabel)\ 
fsel_input  (pipath,  pisel,  pbutton) 
ttdefine  wind_new() 

#endif  /*  GEM2  I GEM3  I XGEM  */ 

/iHHf*»***#»»»»*»****»»**»#»lf)t***#»*lHHHHHHt*»**#»»****«*»»****»**»***/ 
/*  MISCELLANEOUS  DEFINITIONS  */ 

/»#***»****»***»*****»***»»»»*****»*#»*****»**#»*»***»»*»*«»********/ 
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# define 

FALSE 

(BOOLEAN) 0 

/* 

# define 

TRUE 

(BOOLEAN) 1 

/* 

# define 

FAILURE  (-1) 

/» 

# define 

SUCCESS 

0 

/* 

# define 

FOREVER 

for  (;;) 

/* 

# define 

EOS 

'\0' 

/* 

# ifndef 

NULL 

# define 

NULL 

OL 

/* 

#endif 

# ifndef 

EOF 

# define 

EOF 

(-1) 

/* 

#endif 

Function  FALSE  value  */ 

Function  TRUE  value  */ 

Function  failure  return  val  */ 
Function  success  return  val  */ 
Infinite  loop  declaration 
End  of  string  value  */ 


Null  long  value  */ 


EOF  value  */ 


#endlf  /*  __P0RTAB__  */ 


Das  Benutzen  dieser  Datei  ist  denkbar  einfach.  Lesen  Sie  sie  dazu  in  einen  Texteditor 
ein  und  andern  Sie  3 Ziffern.  Dann  konnen  Sie  Ihr  Programm  in  jeder  GEM-Umgebung 
ubersetzen  und  laufen  lassen. 


Zuerst  andern  Sie  das  Betriebssystem  ab.  Falls  die  „1“  mil  Ihrem  Betriebssystem  nicht 
ubereinstimmt,  ersetzen  Sie  sie  durch  eine  „0“  und  die  entsprechende  „0“  durch  eine 
„1“.  Dasselbe  machen  Sie  mil  dem  Prozessor  sowie  dem  verwendeten  Compiler. 

Falls  Sie  nicht  die  Default-GEM-Version  des  jeweiligen  Betriebssystems  benutzen,  an- 
dern Sie  die  GEM-Definition  entsprechend  ab.  Jetzt  konnen  Sie  schon  Ihr  erstes  GEM- 
Programm  ubersetzen  lassen. 

Wenn  Sie  Include-Dateien  des  Compilers  benutzen,  sollten  diese  zuerst  eingebunden  wer- 
den.  Danach  konnen  PORTAB  und  die  GEM-Header  VDI  und  AES  benutzt  werden. 
Beispiel: 

# include  <stdio.h>  /*  Compiler-speziflsch  */ 

# include  <string.h>  /*  Compiler-spezifisch  */ 

# include  <portab.h> 

# include  <vdi.h> 

# include  <aes.h> 

GLOBAL  WORD  main  () 

[ 

...  GEM-Programm. . . 

] /*  main  */ 
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Wie  Sie  an  den  spitzen  Klammern  sehen,  werden  alle  Dateien  zunachst  aus  dem  System- 
Verzeichnis  des  Compilers  geholt.  Dort  hinein  sollten  Sie  auch  alle  Include-Dateien  aus 
dem  Verzeichnis  MISC  auf  der  Beispieldiskette  kopieren,  nachdem  Sie  die  Anderungen 
in  PORTAB.H  gemacht  haben. 


In  den  folgenden  Kapiteln  werden  wir  auf  die  Entwicklungsumgebungen  der  einzelnen 
Compiler  naher  eingehen.  Es  wird  gezeigt,  wie  sich  eine  GEM-Applikation  iibersetzen 
und  linken  laBt.  Als  Beispiel  wahlen  wir  die  GEM-Applikation  SCRAP,  die  ausfuhrlich 
in  Kapitel  6 erlautert  wird. 

Fiir  die  Applikation  SCRAP  befmden  sich  alle  Informationen  zum  Compilieren  und  Lin- 
ken in  den  entsprechenden  Ordnem  der  Betriebssysteme  (GEMDOS,  FLEXOS, 
MSDOS).  In  Kapitel  6.4  wird  die  Einrichtung  der  Entwicklungsumgebung  fiir  diese  Ap- 
plikation noch  genauer  erlautert. 
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Das  Betriebssystem  von  ATARI  (192  KByte  ROM)  stammt  zum  groBten  Teil  von  Digital 
Research.  Dazu  gehort  die  grafische  Benutzeroberflache  GEM  und  das  Disk-Operating- 
System  GEMDOS.  Die  BIOS-  und  XBIOS-Funktionen  von  ATARI  machen  nur  einen 
Bruchteil  der  192  KByte  aus.  Wenn  von  GEMDOS  die  Rede  ist,  meinen  wir  also  immer 
die  GEM-Version  l.X  in  den  ROMs  eines  ATARI  ST. 


Dariiber  hinaus  kann  man  auch  die  GEM-Version  2.2  von  ABC-Software  erwerben,  die 
dann  auf  dem  GEMDOS  aufsetzt.  Sie  miiBten  in  der  Datei  PORTAB.H  lediglich  die  Zeile 
„#  define  GEM  GEM1“  ersetzen  durch: 


# define  GEM  GEM2 

Auf  dem  ATARI  ST  konnen  Accessories  auch  als  Programm  gestartet  und  per  Variable 
(_app)  abgefragt  werden.  Im  Startup-Code  eines  Compilers  muB  dies  allerdings  unter- 
stutzt  werden.  Wo  das  nicht  der  Fall  ist,  werden  die  Quellen  der  angepaBten  Startup- 
Programme  mitgeliefert. 


Um  die  verschiedenen  GEM-Versionen  besser  zusammenfassen  zu  konnen,  wurden  zwei 
neue  Header-Dateien  erstellt.  Die  Dateien  VDI.H  und  AES.H  beinhalten  alle  GEM  l.X, 
GEM  2.x,  GEM/3  und  X/GEM  Funktionen  und  Strukturen,  die  benotigt  werden.  Fiir 
ANSI-Compiler  sind  Prototypen  angegeben.  Sie  ersetzen  die  alten  Dateien  OBDEFS.H 
und  GEMDEFS.H.  Sie  miissen  jeweils  auf  die  Entwicklungsumgebung  des  Compilers 
gespielt  werden.  Dies  wird  im  einzelnen  bei  den  jeweiligen  Compilem  welter  unten  an- 
gegeben. 
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3.1.1  Digital  Research  C 

Dies  war  der  erste  Compiler,  der  fiir  den  ATARI  ST  existierte.  Er  wurde  beim  sogenann- 
ten  „Entwicklungspaket“  1985  ausgeliefert  und  wurde  dort  mit  Namen  CCC  (Compatible 
C-Compiler)  beschrieben.  Alle  Programmierer,  die  mit  diesem  Compiler  arbeiten  muB- 
ten,  konnen  Ihnen  ein  Klagelied  dariiber  singen.  Wir  haben  selbst  die  Erfahrung  machen 
mussen.  Als  wir  noch  bei  der  ADI  Software  GmbH  arbeiteten,  erlebten  wir  beim  Anpas- 
sen  des  ADIMENS-Kems  und  beim  Erstellen  von  ADIMENS  selbst  die  bosesten  Ubera- 
schungen.  Wir  muBten  teilweise  den  Assembler-Quelltext,  den  der  Compiler  erzeugt  hat- 
te,  nach  Fehlern  untersuchen. 

Die  Zeiten  sind  aber  vorbei.  Inzwischen  gibt  es  von  ATARI  den  Nachfolger,  der  sich 
mit  Alcyon  meldet,  aber  sonst  eine  neuere  Version  des  Digital  Research  Compiler  ist. 

Der  Compiler  besteht  aus  3 Passen,  die  Assembler-Quelltext  erzeugen,  einem  Assembler 
(AS68)  und  einem  Linker  (Link68  von  Digital  Research).  Um  Programme  zu  iibersetzen, 
sollte  man  sich  also  eine  Batchdatei  schreiben  und  diese  aus  einem  Kommando-Interpreter 
aus  aufrufen.  Solch  eine  Batchdatei  lautet: 

cp68  %l.c  %l.i 

c068  %l.i  %1.1  %1.2  %1.3  -f 

del  %l.i 

cl68  %1.1  %1.2  %l.s 
del  %1.1 
del  %1.2 
as68  -1  -u  % l.s 
del  %l.s 

link68  % 1 .68k =gemstart,  % 1 ,vdibind,aesbind,osbind,gemlib,libf 
del  %l.o 
relmod  % 1.68k 
del  % 1.68k 

Im  Ordner  \GEMDOS\DR_C  befindet  sich  auch  das  modifizierte  GEMSTART.S,  mit 
dem  man  Programme  als  Accessories  laufen  lassen  kann. 

Diese  Assemblerdatei  sollte  zuerst  ubersetzt  werden: 

as68  -I  -u  gemstart.s 

Die  resultierende  Objektdatei  GEMSTART.O  sollte  daim  immer  mitgelinkt  werden.  Das- 
selbe  gilt  fur  die  Datei  VQ_GDOS.S,  die  einer  Applikation  die  Moglichkeit  gibt  abzu- 
fragen,  ob  das  GDOS  installiert  ist  oder  nicht.  Setzen  Sie  die  resultierende  Datei 
VQ_GDOS.O  mit  Hilfe  des  Archivers  AR68  in  die  VDI-Library  VDIBIND  oder  linken 
Sie  die  Objektdatei  immer  mit  dazu.  In  letzterem  Fall  muB  die  Link-Zeile  dann  so 
aussehen: 


link68  % 1 .68k=gemstart,  % 1 ,vdibind,aesbind,vq_gdos,osbind,gemlib,libf 
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Eine  Abfrage  mittels  VQ_GDOS  befindet  sich  im  Beispielprogramm  SHOWGEM. 


Eigene  Libraries  konnen  erstellt  Oder  bestehende  Libraries  geandert  werden,  wenn  Sie 
das  Programm  AR68.PRG  benutzen.  Die  nachfolgende  Batchdatei  erstellt  die  Library 
SCRAPLIB  durch  Hinzufiigen  eines  neuen  Moduls  und  loscht  anschlieBend  die  Ob- 
jektdatei: 


ar68  rv  scraplib  %I.o 
del  %l.o 

Urn  das  Beispielprogramm  SCRAP  komplett  zu  iibersetzen,  muB  nur  die  Batchdatei 
c all  aufgerufen  werden.  Sie  hat  folgendes  Aussehen: 


c gemain 
c inlterm 
c graf 
c power 
c edit 
c image 
c meta 
c clipbrd 
c printer 
c disk 
c trash 
c desktop 
c event 
c menu 
c resource 
c rcm 
c windows 
c global 
1 


Zuerst  werden  alle  Module  compiliert  und  anschlieBend  mit  „l.bat“  gelinkt.  Die  Batch- 
datei „l.bat“  sieht  wie  folgt  aus: 


link68  scrap.68k=gemstart, scraplib, vdibind,aesbind,osbind,gemlib,libf 
relmod  scrap. 68k 
del  scrap. 68k 


Die  aufgefuhrte  Library  „scraplib“  wird  durch  die  vorangegangenen  Aufrufe  von  „c.bat“ 
erstellt.  Zum  SchluB  ist  das  fertige  Programm  SCRAP.  PRG  zum  Start  verfiigbar.  Soil 
es  als  Accessory  laufen,  muB  der  Name  in  SCRAP. ACC  umbenannt  werden. 
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3.1.2  Laser  C 

Die  Entwicklungsumgebung  fiir  Laser  C ist  wesentlich  einfacher  als  die  von  Digital  Re- 
search C.  Dort  gibt  es  das  machtige  Kommando  „niake“,  mit  dem  sich  automatisch  groBe 
Projekte  verwalten  lassen. 

Eine  Makedatei  definiert  die  Abhangigkeiten  von  Modulen  untereinander.  Uber  Makros 
konnen  auBerdem  Namen  zusammengefaBt  werden.  Jedes  Modul  MODUL.C  ist  z.B.  ab- 
hangig  von  seiner  Header-Datei  MODUL.H.  Inkludiert  ein  Modul  auch  andere  Module, 
so  ist  es  von  diesen  ebenfalls  abhangig.  Andert  sich  das  Datum  beim  Modifizieren  eines 
Moduls,  so  werden  bei  einem  Make-Vorgang  automatisch  alle  Dateien  neu  iibersetzt,  die 
von  dem  modifizierten  Modul  abhangig  sind  und  deren  iibersetzte  Objekt-Datei  (mit  Suf- 
fix .o)  ein  jiingeres  Datum  aufweisen. 

Die  Makedatei  der  Applikation  SCRAP  fiir  Laser  C sieht  dann  wie  folgt  aus: 


#####  MAKEFILE  fiir  SCRAP  ##### 

##########################################################«###### 
NAME  = scrap 

################################################################# 
CFLAGS  = 

LFUGS  = 

APP  = .prg 


H = import. h export. h global. h 

OBJS  = clipbrd.o  desktop. o disk.o  edit.o  event. o gemain.o 

global. o graf.o  image. o initerm.o  menu.o  meta.o  power. o 
printer. o rcm.o  resource. o trash. o windows. o 

II  M II  M II  II  II  II  IF  If  If  If  Tt  FT  TT  TT  TT  TT  TT  TT  TT  TTTT  TTTT  TT  TT  TT  TT  TT  TTTT  TT  M M IT  M II 

$(NAME)$(APP) : $(0BJS) 

$(CC)  $(OBJS)  $(LFLAGS)  -o  $@ 
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clipbrd.o  : 

desktop. o : 

disk.o  : 
edit.o  : 

event . o : 
gemain.o  ; 
global. o : 
graf.o  : 
image . o : 
initerm.o  : 


menu . o 

meta.o 
power. 0 
printer. o 
rcm.o 

resource. o 
trash. o 
windows. o 


$(H)  windows. h $(NAME) .h  resource. h desktop. h edit.h 
image. h meta.h  trash. h clipbrd.h 

$(H)  windows. h |(NAME) .h  clipbrd.h  disk.h  event. h raenu.h 
printer. h trash. h desktop. h 
1(H)  windows. h $(NAME).h  disk.h 

$(H)  windows. h $(NAME).h  resource. h desktop. h clipbrd.h 
edit.h 

$(H)  windows. h desktop. h menu.h  event. h 

$(H)  initerm.h  event. h gemain.h 

$(H) 

$(H)  windows. h $(NAME).h  graf.h 

$(H)  windows. h $(NAME).h  resource. h clipbrd.h  image. h 
$(H)  windows. h resource. h menu.h  event. h desktop. h 
trash. h disk.h  printer. h edit.h  clipbrd.h  image. h meta.h 
graf.h  power. h initerm.h 

$(H)  windows. h $(NAME) .h  desktop. h graf.h  power. h 
resource. h menu.h 

$(H)  windows. h $(NAME).h  resource. h clipbrd.h  meta.h 
$(H)  windows. h $(NAME).h  power. h 
$(H)  windows. h $(NAME).h  printer. h 
rcm.h 

$(H)  $(NAME).h  resource. h 

$(H)  windows. h $(NAME).h  desktop. h clipbrd.h  trash. h 
$(H)  windows. h 


NAME  ist  ein  Makro  und  hat  den  Inhalt  „scrap“.  Der  Name  der  Applikation  muB  also 
eingetragen  werden. 

CFLAG  und  LFLAGS  beinhalten  Compiler-  bzw.  Linkerflags,  die  zusatzlich  gesetzt  wer- 
den konnen.  So  kann  z.B.  bei  CFLAGS  noch  -Z  angegeben  werden,  wenn  der  Debugger 
benutzt  werden  soil. 

APP  muB  den  Suffix  fiir  den  Programmnamen  beinhalten.  Auf  einem  ATARI  ST  wird 
dieser  Suffix  meist  „.PRG“  sein.  Soil  das  Programm  nur  als  Accessory  iibersetzt  werden, 
so  wird  man  APP  auf  den  Wert  „.ACC“  setzen. 

H beinhaltet  die  3 Header-Dateien  IMPORT. H,  EXPORT. H und  GLOBAL. H.  Diese  3 
Dateien  werden  in  jedem  Modul  benotigt,  d.h.  alle  Module  sind  von  diesen  3 Dateien 
abhangig. 

OBJS  beinhaltet  den  Objektcode  aller  Module  der  gesamten  Applikation,  sind  also  iiber- 
setzte  Dateien  mit  Suffix  „.0“. 
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Jetzt  folgen  die  sogenannten  Regeln  (rules).  Die  Regel,  die  hier  angewendet  werden  soil, 
lautet  im  Klartext; 


„Die  Applikation,  die  von  den  Objektdateien  clipbrd.o,  desktop. o,...  usw,  abhangt,  soli 
mit  diesen  Dateien  neu  gelinkt  werden,  wenn  das  Programm  alter  ist  als  die  Objektdatei- 
en. Der  Linker  soil  zusatzliche  Flags  benutzen  konnen." 

Mit  $(NAME)  ist  der  Inhalt  von  NAME,  also  „scrap“  gemeint,  so  dal)  die  Regel  ausfiihr- 
lich  lauten  wurde: 


scrap. prg:  clipbrd.o  desktop. o ... 

cc  clipbrd.o  desktop. o ...  -o  scrap. prg 

Der  Wert  von  LFLAGS  ist  in  diesem  Beispiel  leer. 


AnschlieBend  folgen  die  Regeln  fiir  die  einzelnen  Module.  Der  Name  des  Objektcodes 
wird  durch  einen  Doppelpunkt  von  den  Header-Dateien,  von  denen  das  Modul  abhangig 
ist,  getrennt.  Wie  man  sieht,  sind  alle  Module  von  den  Header-Dateien  „import.h“,  „ex- 
port.h“  und  „global.h“  abhangig.  Diese  Dateien  wurden  ja  mit  dem  Makro  H abgekiirzt, 
womit  sich  durch  die  Verwendung  von  $(H)  Schreibaufwand  einsparen  laBt. 


Startet  man  den  Laser  C-Compiler,  so  muB  man  nur  noch  im  Menii  „Make“  den  Menii- 
punkt  „Set  make"  anwahlen  und  die  oben  aufgefiihrte  Datei  „ Makefile"  angeben.  Durch 
Anwahlen  von  „Make“  Oder  „Control-M“  wird  das  gesamte  Projekt  iibersetzt  und  das 
ausfiihrbare  Programm  erzeugt.  Jede  Anderung  an  einem  Modul  mit  anschlieBendem  Ma- 
ke iibersetzt  nur  das  geanderte  Modul  und  linkt  dann  neu. 

Vor  dem  ersten  Ubersetzungslauf  kopieren  Sie  noch  die  beiden  Dateien  VDI.H  und 
AES.H  in  den  Ordner  \MEGAMAX\HEADERS.  Sie  konnen  dann  fiir  jedes  GEM- 
Programm  benutzt  werden. 


3.1.3  Lattice  C 

Mit  dem  Lattice-Compiler  konnen  die  beiden  Dateien  VDI.H  und  AES.H  nicht  benutzt 
werden.  Der  Compiler  kommt  mit  den  Prototypen  nicht  zurecht,  und  Makros,  die  langer 
als  eine  Zeile  sind  (trotz  Benutzung  des  Backslash  „\“)  kann  er  nicht  verarbeiten.  Des- 
halb  kopieren  Sie  die  Dateien  GEMDEFS.H  und  OBDEFS.H  auf  Ihre  Lattice- 
Entwicklungsumgebung  und  nennen  Sie  sie  um  in  VDI.H  und  AES.H. 

Ansonsten  compilieren  Sie  alle  Module  (CLIPBRD.C,  DESKTOP. C,  usw.)  wie  im 
Lattice-Handbuch  beschrieben  und  linken  mit  folgender  Kontrolldatei: 
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* Standard  control  file  for  linking  Lattice  C modules. 

» Step  1 - initialisation 
« ======================= 

» C initialisation  must  be  included  first. 

INPUT  startup.bin 

* Step  2 - user  modules 

* ===================== 

* 

* Now  include  a single  user  module 

* (from  the  command  line). 

» 

* INPUT  * 

INPUT  clipbrd.bin 
INPUT  desktop.bin 
INPUT  dlsk.bin 
INPUT  edlt.bin 
INPUT  event.bin 
INPUT  gemaln.bin 
INPUT  global.bin 
INPUT  graf.bin 
INPUT  image.bin 
INPUT  initerm.bin 
INPUT  menu.bin 
INPUT  meta.bin 
INPUT  power.bin 
INPUT  printer.bin 
INPUT  rcm.bin 
INPUT  resource.bin 
INPUT  trash.bin 
INPUT  windows.bin 
» 

* For  each  extra  module  you  want  to  include  in  the 

* link  Include  a line  of  the  form: 

* 

» INPUT  <file  name> 

* 

* Step  3 - floating  point  library 
» =============================== 

* Comment  out  this  line  if  your  program  does  not  use 

* floating  point 
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* 

LIBRARY  fplib.bin 
* 

* Step  4 - C library 

* 

* C library  - must  always  be  included. 

* 

LIBRARY  clib.bin 
* 

* Step  5 - GEM  graphics  library 

* ============================= 

* 

* GEM  graphics  library  - only  Include  if  your  program 

* is  trying  to  access  graphics  routines 

* (by  uncommenting  the  line) . 

* 

LIBRARY  gemlib.bin 

* 

Zu  beachten  ware  noch,  daft  die  Abfrage,  ob  das  Programm  als  Accessory  gestartet  wur- 
de,  dort  nicht  funktioniert,  da  im  Modul  „startup.bin“  die  Variable  „_app“  nicht  ge- 
setzt  wird.  Es  soli  aber  im  Public-Domain-Bereich  eine  neue  Startup-Datei  existieren. 


3.1.4  Mark  Williams  C 

Zunachst  kopieren  Sie  aus  dem  Ordner  MISC  die  Dateien  VDI.H  und  AES.H  in  den  Ord- 
ner  INCLUDE  ihrer  Mark-Williams-Entwicklungsumgebung.  Aus  dem  Ordner  \GEM- 
DOS\MW_C  kopieren  Sie  die  Datei  STRING. H ebenfalls  in  den  Ordner  INCLUDE. 

Da  auch  beim  Mark-Williams-Compiler  keine  Applikationen  von  Accessories  unterschie- 
den  warden  konnen,  entschieden  wir  uns,  die  Startup-Datei  CRTSO.S,  die  als  Quelltext 
im  Compilerpaket  mitgeliefert  wird,  zu  modifizieren.  Dort  wird  die  Variable  „_app“ 
richtig  gesetzt. 

Kopieren  Sie  also  die  Datei  CRTSO.S  auf  ihren  Mark-Williams-Ordner  in  den  Ordner 
LIB  und  lassen  diese  Datei  mit  Hilfe  des  Befehls 

cc  -c  crtsO.s 

neu  iibersetzen.  Die  resultierende  Objektdatei  CRTSO.O  muft  sich  dann  im  LIB-Ordner 
befinden. 

Kopieren  Sie  auch  die  Datei  STRING. H in  den  INCLUDE-Ordner  Ihrer  Entwicklungs- 
umgebung.  Zum  Schluft  miissen  noch  die  beiden  fehlenden  Objektmodule  FMBUT- 
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TON.O  sowie  FMKEYBD.O  in  die  Library  LIBAES.A  kopiert  werden.  Dazu  bedienen 
wir  uns  des  Programmes  AR.  Zuerst  wechseln  wir  in  den  Ordner  LIB  und  rufen  auf: 

cd  lib 

ar  rsv  libaes.a  fmbutn.o  fmkeybd.o 
cd  .. 

Zum  Ubersetzen  der  SCRAP-Applikation  kann  dann  die  Makedatei  „makefile“  benutzt 
werden.  Sie  ist  identisch  mil  der  Laser-C-Version.  Lediglich  die  Compilerflags 
(CFLAGS)  sowie  die  Linkerflags  (LFLAGS)  werden  belegt. 

CFLAGS  = -VPEEP 
LFLAGS  = -X  -s  -laes  -Ivdi 


3.1.5  Turbo  C 

Die  Installation  ist  bier  recht  unproblematisch.  Kopieren  Sie  die  Dateien  PORTAB.H, 
VDI.H  sowie  AES.H  auf  den  Ordner  \TC\INCLUDE  Ihrer  Festplatte  oder  Arbeitsdis- 
kette.  Wir  haben  hier  angenommen,  daB  sich  die  Turbo-C-Entwicklungsumgebung  im 
Ordner  \TC  befmdet.  Dieser  wird  auf  MS-DOS-Rechnern  standardmaBig  benutzt. 

Das  einzige  Problem  besteht  beim  direkten  Aufruf  von  VDI-Befehlen  iiber  die  GEM- 
Funktion  vdi().  Die  Entwickler  von  Turbo  C auf  dem  ATARI  ST  haben  sich  hier  nicht 
an  die  Standards  von  Digital  Research  gehalten,  was  mehr  als  argerlich  ist.  Sie  ignorierten 
die  Original-Bindings  einfach. 

Fullt  man  bei  VDI-Befehlen  die  Felder  contrl,  intin  und  ptsin  selbst,  so  kann  man  norma- 
lerweise  vdi()  aufrufen.  Der  Grafikbefehl  wird  dann  ausgefuhrt.  In  dieser  Turbo-C- 
Version  wurde  ins  AES.H  folgende  Struktur  aufgenommen; 


#if  GEMDOS 
#if  TURBO.C 
typedef  struct 
[ 

WORD  contrl  [11]; 

WORD  global  [80]; 

WORD  Intin  [128]; 

WORD  ptsin  [128]; 

WORD  intout  [45]; 

WORD  ptsout  [128]; 

VOID  FAR  »addrin  [128]; 

VOID  FAR  »addrout  [128]; 
] GEMPARBLK; 
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extern  GEMPARBLK  _GemParBlk; 

#endif  /*  TURBO.C  »/ 

#endif  /*  GEMDOS  */ 

Alle  VDI-  und  AES-Aufrufe  werden  iiber  die  Variable  „_GemParBlk“  getatigt.  Selbst 
wenn  man  den  _GemParBlk  fiillt  und  danach  _VdiCtrl()  aufruft  (statt  vdi)  passiert 
nichts.  Die  VDI-Schnittstelle  von  Turbo  C ist  also  total  unbrauchbar.  Aus  diesem  Grunde 
und  vor  allem  urn  portabel  fiir  alle  anderen  Compiler  zu  sein,  haben  wir  die  von  Digital 
Research  definierte  Standard-Schnittstelle  einfach  selbst  geschrieben.  Es  ist  folgende  klei- 
ne  Assemblerdatei,  die  sich  unter  dem  Namen  VDICALL.S  auf  der  Diskette  befmdet: 

» VDICALL.S 

* for  vdicalls 


*»»»  Export  references  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
.EXPORT  vdi 

»»»»Import  references«<<«  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 

.IMPORT  contrl 
.IMPORT  intin 
.IMPORT  ptsin 
.IMPORT  intout 
.IMPORT  ptsout 

*»»»Data  segment«««««««««««««««««««««««« 
.BSS 

*»»»>Initialized  data  segment  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
.DATA 

pblock:  .DC.L  contrl 
.DC.L  intin 
.DC.L  ptsin 
.DC.L  intout 
.DC.L  ptsout 

*»»»>  Code  segment  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
.CODE 

********  VDI  ******************************************************** 

vdi:  MOVE.L  #pblock,Dl 

MOVE.W  #$73, DO 


3.1  ATARI  GEMDOS 
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TRAP  #2 
RTS 

*»»***»*  Module  end  »»*»»»*»»»*)nt**»»)HH()(»)Ht»»**»*»»*»»»**»*****»»*»* 
.END 

Wie  Sie  sehen,  wurde  hier  die  VDI-Schnittstelle  unter  Einhaltung  der  Konventionen  aus 
Kapitel  2 realisiert  (Adresse  des  Parameterblockes  in  Register  Dl,  Wert  115 =$73  in  Re- 
gister DO).  Die  resultierende  Objektdatei  VDICALL.O  befindet  sich  fur  alle  diejenigen, 
die  den  Turbo-C-Assembler  nicht  besitzen,  ebenfalls  auf  Diskette.  Wenn  Sie  direkte  VDI- 
Aufrufe  tatigen  mochten,  wie  dies  in  VDITEST,  SHOWGEM  und  SCRAP  getan  wird, 
so  linken  Sie  iiber  die  entsprechende  Projektdatei  das  Modul  VDICALL.O  immer  mit 
dazu.  Sie  konnen  VDICALL.O  auch  in  Hire  GEM-Library  TCGEMLIB.LIB  mit  aufneh- 
men.  Dann  ersparen  Sie  sich  die  Angabe  in  der  Projektdatei. 

Die  Projektdatei  fiir  die  Applikation  SCRAP  sieht  (ohne  Abhangigkeiten)  wie  folgt  aus; 


; SCRAP. PRJ 


.C[-W-par  -W-slg] 

= ; list  of  modules  follows... 

tcstart.o  ; startup  code 

vdicall.o  ; direct  vdi  calls 

clipbrd 

desktop 

disk 

edit 

event 

gemain 

global 

graf 

image 

initerm 

menu 

meta 


power 

printer 

rcm 

resource 

trash 

windows 

tcfltlib.lib 

tcstdlib.lib 

tcextlib.lib 

tctoslib.lib 

tcgemlib.lib 


[-W-rpt] 


floating  point  lib 
standard  lib 
extended  lib 
TOS  lib 

AES  and  VDI  lib 
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Fur  alle  Module  mil  Suffix  „.C“  werden  folgende  Warnmeldungen  abgeschaltet: 

-W-par  = Parameter  werden  in  Funktion  nicht  benutzt 

-W-sig  = Verlust  von  signifikanten  Stellen  beim  impliziten  Cast-Operator. 

Die  erste  Warnmeldung  wird  ausgeschaltet,  damit  gewisse  Standardfunktionen  in  SCRAP 
immer  die  gleiche  Schnittstelle  haben,  obwohl  vielleicht  der  eine  oder  andere  Parameter 
nicht  benotigt  wird. 

Die  zweite  Warnmeldung  tritt  z.B  auf,  wenn  ein  float-Wert  einem  int-Wert  zugewiesen 
wird.  Beispiel: 

FLOAT  f; 

LONG  1; 

WORD  i; 

f = 3.12; 

1 = 12; 

i = f;  /*  hier  Warnung  von  Verlust  signifikanter  Stellen  */ 

1=1;/*  auch  hier  Warnung  */ 

Vor  allem  in  der  Applikation  SHOWGEM  werden  haufig  bewuBt  solche  impliziten  Typ- 
umwandlungen  vorgenommen.  Die  Cast-Operation 

i = (WORD)f; 

1 = (WORD)l; 

hatte  die  Warnmeldungen  verhindert,  was  uns  aber  zuviel  Schreibaufwand  war. 


3.2  MS-DOS  und  FlexOS 

MS-DOS  und  FlexOS  laufen  auf  Rechnem  der  INTEL-Familie.  Dort  muB  lediglich  be- 
achtet  werden,  daB  die  GEM-Programme  auf  den  Disketten  im  sogenannten  Large- 
Modell  iibersetzt  werden. 

Bei  Benutzung  von  Bit-Image- Dateien  muB  der  Kopf  nach  dem  Einlesen  wort-  bzw. 
langwortweise  vertauscht  werden  (siehe  SHOWGEM  und  Kapitel  2.5),  da  er  im 
68000-Modell  vorliegt. 


3.2.1  Microsoft  C 

Kopieren  Sie  zunachst  die  Dateien  PORTAB.H,  VDI.H  und  AES.H  in  den  Ordner  IN- 
CLUDE, in  dem  sich  Ihr  Microsoft  C-Compiler  befindet.  Vergessen  Sie  aber  nicht,  in 
der  Datei  PORTAB.H  Ihr  Betriebssystem  sowie  Ihren  Compiler  und  den  Prozessortyp 
l‘^(I8086)  einzustellen. 


3.2  MS-DOS  und  FlexOS 
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Zum  Ubersetzen  der  SCRAP-Applikation  kann  dann  die  Makedatei  „makefile“  benutzt 
warden. 

# # # # # MAKEFILE  fur  SCRAP  # # # # # 

#################«#################«###############«##«###«###### 
NAME  = scrap 

################################################################# 
CFLAGS  = -AL  -Oas  -Gs 

LFLAGS  = /ST: 12288  /SE:512  /NOI  /E 
APP  = . app 

################################################################# 
.c.obj : 

cl  -c  $(CFLAGS)  $».c 

.asm.obj : 

raasra  /Mx  $»; 

#####################################«#######«################### 
H = |».c  $*.h  import. h export. h global. h 

OBJS  = clipbrd.obj  desktop. obj  dlsk.obj  edit.obj  event. obj\ 
geraaln.obj  global. obj  graf.obj  image. obj  initerm.objX 
menu. obj  meta.obj  power. obj  printer. obj  rcm.obj\ 
resource. obj  trash. obj  windows. obj 

################################«############################«### 

clipbrd.obj  : $(H)  windows. h $(NAME).h  desktop. h edit.h  image. h\ 
meta.h  trash. h 

desktop. obj  : $(H)  windows. h $(NAME).h  disk.h  event. h menu.hX 
pr inter. h trash. h clipbrd.h 

disk. obj  : $(H)  windows. h $(NAME).h 
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edit.obj 

event . ob j 
gemain.obj 
global. obj 
graf.obj 
image . obj 
inlterm.obj 

menu. obj 


$(H)  windows. h $(NAME) .h  resource. h desktop. h\ 
clipbrd.h 

1(H)  windows. h desktop. h menu.h 

$(H)  initerm.h  event. h 

$(H) 

$(H)  windows. h $(NAME).h 

$(H)  windows. h $(NAME).h  resource. h clipbrd.h 

$(H)  windows. h $(NAME).h  resource. h menu.h  event. h\ 
desktop. h trash. h disk.h  pr inter. h clipbrd.h  edit.hX 
image. h meta.h  graf.h  power. h 

$(H)  windows. h $(NAME).h  desktop. h graf.h  power. h\ 
resource. h 


meta.obj  : 
power. obj  : 
printer. obj  : 
rcm.obj  : 
resource. obj : 
trash . obj  : 
windows. obj  : 


$(H)  windows. h $(NAME).h  resource. h clipbrd.h 
$(H)  windows. h $(NAME).h  resource. h 
$(H)  windows. h $(NAME).h 
$(H) 

$(H)  $(NAME).h 

$(H)  windows. h $(NAME).h  desktop. h clipbrd.h 
1(H) 


$(NAME)$(APP)  : $(0BJS) 

link  $(LFLAGS)  @$(NAME).lnk 

################################################################# 

Die  Makedatei  sieht  fast  so  aus  wie  fiir  Laser  C oder  Mark  Williams  C.  Hier  wird  von 
den  Compiler-  und  Linkerflags  Gebrauch  gemacht.  Beachten  Sie  die  Ubersetzung  im 
Large-Modell  (-AL)  sowie  die  moglichen  Optimierungen  (-Oas  -Gs). 


3.2  MS-DOS  und  FlexOS 
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Fiir  die  Applikation  wird  beim  Linken  ein  Stack  von  12  KByte  reserviert.  Das  Suffix  unter 
MS-DOS  lautet  immer  „.APP“. 

AnschlieBend  folgt  die  Regel  fiir  die  Ubersetzung  von  C-Dateien  in  Objektdateien.  Es 
wird  der  Compiler  (cl)  aufgerufen,  der  ein  Modul  nur  ubersetzen  soli  (-c  = compile  on- 
ly). Fiir  Assemblermodule  (Dateien  mit  Suffix  „.ASM“)  gibt  es  eine  entsprechende 
Regel. 

SchlieBlich  folgen  die  Makros  fiir  die  Header-  und  Objektdateien  wie  in  den  anderen 
Makedateien  waiter  oben. 


3.2.2  Turbo  C 

Kopieren  Sie  zunachst  die  Dateien  PORTAB.H,  VDI.H  und  AES.H  in  den  Ordner  IN- 
CLUDE, in  dem  sich  Ihr  Turbo-C-Compiler  befindet  (meist  der  Ordner  \TC).  Vergessen 
Sie  aber  nicht,  in  der  Datei  PORTAB.H  Ihr  Betriebssystem  sowie  Ihren  Compiler  und 
den  Prozessortyp  (18086)  einzustellen. 

Die  Konfigurationsdateien  fiir  Turbo  C werden  ebenfalls  mitgeliefert.  Kopieren  Sie  sie 
in  Ihren  Ordner,  in  dem  die  Applikation  entwickelt  werden  soil.  Das  Modell  miiBte  beim 
Starten  von  Turbo  C dann  auf  LARGE  stehen. 

Die  Projektdatei  fiir  das  Ubersetzen  der  Applikation  SCRAP  (ohne  Abhangigkeiten) 
lautet: 

clipbrd 

desktop 

disk 

edit 

event 

gemain 

global  , 

graf 

image 

initerm 

menu 

meta 

power 

printer 

rcm 

resource 

trash 

windows 

Itcgem.lib 
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Die  Library  „ltcgem.lib“  muB  selbst  hergestellt  werden.  Diese  Arbeit  wird  aber  vom  neu- 
en  Programmer’s  Toolkit  von  Digital  Research  sehr  vereinfacht.  Die  Library  enthalt  die 
VDI-  und  AES-Funktionen,  sowie  eine  direkte  Schnittstelle  zum  DOS  und  weitere  Funk- 
tionen. 


3.2.3  High  C 

Kopieren  Sie  zunachst  die  Dateien  PORTAB.H,  VDI.H  und  AES.H  in  den  Ordner  IN- 
CLUDE, in  dem  sich  Ihr  High  C-Compiler  befindet.  Vergessen  Sie  aber  nicht,  in  der 
Datei  PORTAB.H  Ihr  Betriebssystem  sowie  Ihren  Compiler  und  den  Prozessortyp 
(18086)  einzustellen. 

Die  Makedatei  fur  den  High-C-Compiler  sieht  wie  folgt  aus: 


####  MAKEFILE  fiir  SCRAP  #### 

################################################################# 
NAME  = scrap 

#############################«########«########################## 
CFLAGS  = -Off  Prototype_overwrlte_warnings  -On  PCC_msgs 


LFLAGS  = 

APP  = .286 

################################################################# 
COMPILE  = he  $».c  $( CFLAGS) 

################################################################# 
H = import. h export. h global. h 

OBJS  = clipbrd.obj  desktop. obj  disk.obj  edit.obj  event. obj\ 
gemain.obj  global. obj  graf.obj  Image. obj  Inlterm.objV 
menu. obj  meta.obj  power. obj  printer. obj  rcm.objX 
resource. obj  trash. obj  windows. obj 


3.2  MS-DOS  und  FlexOS 
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»»#»#»»»»»»»»##»##»»#»»##»»»»#»»»»#»»»»»*#*#**##»»*»**»»»###»##»» 

$(NAME)$(APP):  $(OBJS) 

link86  $(LFLAGS)  $(NAME) . inp[i] 


clipbrd.obj  : clipbrd.c  clipbrd.h  windows. h $(NAME).h  resource. h\ 
desktop. h edit.h  image. h meta.h  trash. h 

^(COMPILE) 

desktop. obj  : desktop. c desktop. h windows. h $(NAME).h  disk.h  event. h\ 
menu.h  printer. h trash. h clipbrd.h 

$(COMPILE) 

disk. obj  : disk.c  disk.h  windows. h $(NAME).h 
$(C0MPILE) 

edit. obj  : edit.c  edit.h  windows. h $(NAME) .h  resource. h desktop. h\ 
clipbrd.h 

$(C0MPILE) 

event. obj  : event. c event. h windows. h desktop. h menu.h 
KCOMPILE) 

gemain.obj  : gemain.c  gemain.h  initerm.h  event. h 
KCOMPILE) 

global. obj  : global. c global. h 
$( COMPILE) 

graf.obj  : graf.c  graf.h  windows. h $(NAME) .h 
KCOMPILE) 

image. obj  : image. c image. h windows. h $(NAME).h  resource. h\ 
clipbrd.h 

$( COMPILE) 

initerm.obj  : initerra.c  initerm.h  windows. h $(NAME).h  resource. h\ 
menu.h  event. h desktop. h trash. h disk.h  printer. h\ 
clipbrd.h  edit.h  image. h meta.h  graf.h  power. h 

$(COMPILE) 
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menu.obj  : menu.c  menu.h  windows. h $(NAME).h  desktop. h graf.hX 
power. h resource. h 

$(C0MPILE) 

meta.obj  : meta.c  meta.h  windows. h $(NAME).h  resource. h cllpbrd.h 
$(COMPILE) 


power. obj  : power. c power. h windows. h $(NAME).h  resource. h 
$(C0MPILE) 


printer. obj  : printer. c printer. h windows. h $(NAME).h 
$(COMPILE) 


rcm.obj  : rcm.c  rcm.h 
$(COMPILE) 


resource. obj : resource. c resource. h $(NAME).h 
$(COMPILE) 


trash. obj  : trash. c trash. h windows. h $(NAME).h  desktop. h cllpbrd.h 
$(COMPILE) 


windows. obj  : windows. c windows. h 
$(C0MPILE) 


4 Aufgabenstellung  eines  kleinen 
GEM-Programmes 


In  diesem  Kapitel  wird  ein  GEM-Programm  vorgestellt,  das  als  Ausgabeprogramni  uni- 
versell  einsetzbar  ist.  Gezeigt  werden  soil  vor  allem  das  Handling  von  Dialogboxen,  Feh- 
lermeldungen  und  das  Benutzen  der  MS-DOS-  bzw.  GEMDOS-Funktionen  zur  Erhbhung 
der  Portabilitat. 

AuBerdem  werden  benutzerdefinierte  Objekte  in  einer  Dialogbox  verwendet,  um  die 
Technik  klarzumachen.  Auch  die  Transformation  von  Piktogrammen  und  Bildern  vom 
Standardformat  ins  geratespezifische  Format  wird  gezeigt. 

Die  Hauptaufgabe  des  Programmes  ist  die  Ausgabe  von  beliebigen  Vektor-  und  Pixelgra- 
fiken,  die  im  GEM-Format  (Kapitel  2.5)  vorliegen,  auf  eines  der  folgenden  Ausgabe- 
gerate: 


— Bildschirm 
— Plotter 
- Drucker 
— Kamera 

Werden  Vektorgrafiken  ausgegeben,  so  soil  eine  exakte  Skalierung  stattfinden.  Eine  Li- 
nie  von  5 Zoll  Lange  soil  auch  genau  so  auf  einem  Drucker,  Plotter  oder  auf  einer  Kamera 
wiedergegeben  werden. 

Fiir  den  Bildschirm  soil  ebenfalls  die  Moglichkeit  der  exakten  Skalierung  bestehen.  Dies 
ist  aber  nicht  ohne  weiteres  moglich.  Beim  Offnen  einer  Arbeitsstation  erhalt  man  zwar 
die  Anzahl  der  Pixel  in  x-  und  y-Richtung,  sowie  die  Breite  und  Hohe  eines  einzelnen 
Pixel  in  1/1000  mm.  Die  Werte  gelten  aber  nicht  ffir  einen  Bildschirm.  Das  VDI  weiB 
nicht,  ob  z.B.  ein  Bildschirm  von  IBM  oder  ein  NEC  Multisync  angeschlossen  ist.  Daher 
Mt  sich  iiber  die  exakte  GrbCe  eines  Bildschirmpunktes  nur  wenig  aussagen.  Lediglich 
der  sogenannte  „ Aspect  ratio",  also  das  Verhaltnis  von  x zu  y lalit  sich  bestimmen. 
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Es  bleibt  nur  ein  Losungsweg:  Ausmessen  der  GroBe  des  sichtbaren  Bildschirmes.  Das 
Programm  kann  dann  aus  der  Anzahl  der  Pixel  die  wirkliche  GroBe  eines  Bildpunktes 
bestimmen. 

Bei  der  Ausgabe  von  Pixelgrafiken  sollen  nicht  nur  monochrome  Bilder  korrekt  angezeigt 
werden.  Jede  Kombination  soli  moglich  sein.  Eine  Grafik  mil  16  Farben  auf  einem  Bild- 
schirm  mit  4 Farben,  eine  monochrome  Grafik  auf  einem  Farbbildschirm  usw.  Dabei  sol- 
len Farbbilder,  die  n Farben  beinhalten,  auf  einen  Bildschirm  mit  weniger  als  n Farben 
konvertiert  werden. 

Zur  Darstellung  einer  Grafik  (Vektor  oder  Pixel)  soil  eine  Datei  mit  Suffix  „.GEM“  uber 
die  GEM  Dateiauswahlbox  angewahlt  werden.  Pixelgrafiken  mit  Suffix  „.IMG“  werden 
auch  iiber  die  gleichnamigen  Dateien  mit  Suffix  „.GEM“  angewahlt.  Zu  jeder  Pixelgrafik 
erzeugt  GEMPAINT  namlich  auch  eine  Datei  mit  Suffix  „.GEM“,  die  Zusatzinformatio- 
nen,  wie  die  tatsachliche  Ausdehnung  der  Grafik  in  Pixel,  enthalt. 


4.1  Die  Bedienung  von  SHOWGEM 

Nach  dem  Start  des  Programmes  erscheint  die  GEM-Dateiauswahlbox.  Es  werden  alle 
Dateien  aus  dem  aktuellen  Ordner,  also  aus  dem  Ordner,  aus  dem  SHOWGEM  gestartet 
wurde,  angezeigt. 

Dort  kann  man  eine  beliebige  GEM-Datei  anwahlen  und  den  OK-Knopf  driicken.  An- 
schlieBend  erscheint  eine  Dialogbox,  die  die  Einstellung  von  Ausgabeparametern  erlaubt. 


Abb.  4.1:  Dialog  von  SHOWGEM 


4.1  Die  Bedienung  von  SHOWGEM 
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Man  kann  jetzt  sofort  den  Knopf  START  drucken,  um  sich  die  Grafik  auf  dem  Bildschirm 
anzeigen  zu  lassen.  Man  kann  aber  auch  direkt  mil  der  Mans  Anderungen  vornehmen. 

Wahlen  Sie  zunachst  das  gewiinschte  Ausgabegerat  an.  Standardm^ig  ist  der  Bildschirm 
selektiert.  Sie  konnen  aber  mil  der  Mans  auch  auf  ein  anderes  Gerat  wechseln.  Wenn  Sie 
es  anklicken,  erscheint  das  gewahlte  Gerat  invertiert. 

AnschlieBend  konnen  Sie  Bildparameter  einstellen.  Sie  gelten  nur  fiir  Metadateien,  also 
Vektorgrafiken,  da  diese  auf  einfache  Weise  skaliert  werden  konnen. 

Sie  konnen  unter  2 Ausgabeanpassungen  wahlen,  wobei  Einpassen  vorbelegt  ist: 

- Original 

- Einpassen 

Wird  Original  gewahlt,  so  wird  die  Vektorgrafik  in  der  OriginalgroBe  ausgegeben.  Das 
bedeutet,  daB  Langenbeziehungen  erhalten  bleiben.  Eine  Linie  von  1 cm  in  der  Grafik 
bedeutet,  daB  sie  mit  der  gleichen  Lange  auf  das  Ausgabegerat  gebracht  wird.  Hier  pas- 
siert  es  haufig,  daB  die  Grafik  nie  ganz  auf  den  Bildschirm  paBt.  Wurde  z.B.  in  GEM- 
DRAW  eine  Grafik  im  DIN  A4-Format  Hochformat  erzeugt,  so  wird  bei  der  Ausgabe 
(meist  auf  den  Bildschirm)  das  Bild  eventuell  abgeschnitten. 

Wird  Einpassen  gewahlt,  so  wird  die  Vektorgrafik  an  das  Ausgabegerat  angepaBt.  Eine 
groBe  Grafik  wird  dann  so  weit  verkleinert,  bis  sie  ganz  auf  das  Ausgabegerat  paBt.  Ist 
eine  Grafik  kleiner  als  die  Flache  auf  dem  Ausgabegerat,  so  wird  die  Grafik  entsprechend 
vergroBert.  Die  Grafik  paBt  sich  also  exakt  dem  Gerat  an. 

Zusatzlich  konnen  Sie  Ein-  oder  Ausschalten,  ob  beim  Zeichnen  der  Grafik  mit  der  Taste 
<ESC>  abgebrochen  werden  kann  oder  nicht.  Ist  die  Option  eingeschaltet,  kann  mit  je- 
der  beliebigen  Taste  die  Ausgabe  der  Grafik  vorubergehend  angehalten  werden. 

Falls  Sie  die  Grafik  auf  dem  Bildschirm  ausgeben  mochten,  konnen  Sie  auf  Wunsch  Ihren 
Bildschirm  abmessen  und  die  Breite  sowie  die  Hohe  in  die  entsprechenden  Felder  eintra- 
gen.  Die  Zahlen,  die  dort  beim  Start  automatisch  eingetragen  worden  sind,  wurden  iiber 
das  VDI  berechnet  und  konnen  falsch  sein.  Auf  einem  VGA-Monitor  beispielsweise  stim- 
men  die  MaBe  nicht  einmal  annahernd  mit  der  Realitat  iiberein.  Wenn  Sie  die  richtigen 
GroBen  eingetragen  haben,  erscheinen  Grafiken  auch  auf  dem  Bildschirm  exakt  skaliert. 

Nachdem  Sie  alle  Einstellungen  vorgenommen  haben,  konnen  Sie  auf  den  Knopf  START 
drucken,  und  die  Ausgabe  beginnt.  Wahlen  Sie  den  Knopf  ABBRUCH,  um  zur  Dateiaus- 
wahlbox  zuriickzukehren. 

Wurde  eine  Grafik  auf  dem  Bildschirm  ausgegeben,  so  wartet  das  Programm  auf  das 
Drucken  einer  Taste  oder  eines  Mausknopfes.  Danach  erscheint  wieder  die  Dateiauswahl- 
box,  und  Sie  konnen  weitere  Ausgaben  vornehmen. 
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Das  Programm  wird  abgebrochen,  wenn  Sie  in  der  Dateiauswahibox  den  Knopf  AB- 
BRUCH  wahlen. 

Am  Beispiel  dieser  Dialogbox  sehen  Sie  gleich  den  Vorteil  von  benutzerdefinierten  Ob- 
jekten.  Wir  haben  fiir  sogenannte  Radio-Buttons  runde  Knopfe  mit  einem  schwarzen  Kern 
benutzt.  Dies  entspricht  der  Konvention  auf  einem  Apple  Macintosh  oder  der  Konvention 
unter  dem  Presentation  Manager  bzw.  unter  Microsoft  Windows.  Der  Benutzer  sieht  so- 
fort,  dafS  das  Anwahlen  des  Knopfes  „Original“  den  Knopf  „Einpassen“  deselektiert  und 
umgekehrt. 

Die  sogenannten  „Checkboxen“  sind  ankreuzbare  Kastchen.  Selektiert  man  eines  davon, 
so  erscheint  in  ihm  ein  Kreuz.  Jede  Checkbox  kann  einzeln  an-  bzw.  ausgeschaltet  wer- 
den.  Dies  entspricht  ebenfalls  der  Konvention  auf  einem  Apple  Macintosh  oder  der  Kon- 
vention unter  dem  Presentation  Manager  bzw.  unter  Microsoft  Windows.  Auch  hier  sieht 
der  Benutzer  durch  die  Form  eines  Rechteckes  sofort,  dafi  das  Anwahlen  einer  Checkbox 
unabhangig  von  anderen  Checkboxen  erfolgt. 

Die  Verwaltung  von  runden  Radio-Buttons  und  Checkboxen  wird  im  Programm  SHOW- 
GEM  sowie  SCRAP  ausfuhrlich  gezeigt.  Nun  ist  es  an  Ihnen,  den  Software-Entwicklern, 
etwas  mehr  Standardisierung  bei  der  Gestaltung  von  ansprechenden  Dialogboxen  hinein- 
zubringen.  Nehmen  Sie  sich  jetzt  ein  Beispiel  am  Apple  Macintosh  und  dem  Presentation 
Manager.  Der  Benutzer  wird  es  Ihnen  danken. 


4.2  Erlauterungen  zum  Programm  SHOWGEM 


Es  folgt  zunachst  das  komplette  Listing  der  GEM-Applikation  SHOWGEM.  Anschlie- 
ilend  werden  zu  den  einzelnen  Funktionen  Erlauterungen  gegeben,  wo  diese  fiir  das  Ver- 
'standnis  notwendig  sind. 


/*  Mini-Output  Programm,  das  Metadateien  und  Bitimage-Dateien  */ 
/*  auf  ein  beliebiges  Ausgabegerat  sendet  */ 


# include 
# include 
# Include 
# include 
# include 


<stdio.h> 
<string.h> 
<portab.h> 
<vdi.h> 
<aes .h> 


#if  GEMDOS 
# include  <osbind.h> 

# define  MavailO  (LONG)Malloc  (-1L) 
#else 

# include  <gemdos.h> 

# include  <dosbind.h> 
i#endif 
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# include  "showgem.h" 


/**»»»*  DEFINES  »*»»»*»»*»»**»*»*»»»**»»»»»****»»»»»***»»*»»»*»»»**» / 

♦define  DEBUG  0 
♦define  MAX_PLANES  8 
♦define  MAX_PATTERNS  8 

♦define  SCREEN  1 
♦define  PLOTTER  11 
♦define  PRINTER  21 
♦define  METAFILE  31 
♦define  CAMERA  4l 
♦define  TABLET  51 

♦define  NDC  0 
♦define  RC  2 

♦ define 

V.CLRWK 

3 /*  Metafile  VDI  functions  »/ 

♦ define 

V.UPDWK 

4 

♦ define 

V_ESC 

5 

♦define 

V_PLINE 

6 

♦ define 

V.PMARKER 

7 

♦ define 

V.GTEXT 

8 

♦define 

V.FILLAREA 

9 

♦ define 

V_GDP 

11 

♦ define 

VST.HEIGHT 

12 

♦ define 

VST_ROTATION 

13 

♦ define 

VS.COLOR 

14 

♦ define 

VSL_TYPE 

15 

♦ define 

VSL_WIDTH 

16 

♦ define 

VSL_C0L0R 

17 

♦ define 

VSM_TYPE 

18 

♦ define 

VSM_HEIGHT 

19 

♦ define 

VSM_C0L0R 

20 

♦define 

VST.FONT 

21 

♦define 

VST_COLOR 

22 

♦ define 

VSF_INTERIOR 

23 

♦ define 

VSF.STYLE 

24 

♦define 

VSF.COLOR 

25 

♦define 

VSWR_MODE 

32 

♦ define 

VST.ALIGNMENT 

39 

♦ define 

VSF.PERIMETER 

104 

♦ define 

VST.EFFECTS 

106 

♦ define 

VST_P0INT‘  - 

107 

♦ define 

VSL_ENDS 

108 
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# define  VSF.UDPAT  112 
# define  VSL_UDSTY  113 
# define  VR.RECFL  114 
# define  VS.CLIP  129 

# define  V_BAR  1 
# define  V_ARC  2 
# define  V_PIESLICE  3 
# define  V.CIRCLE  4 
# define  V.ELLIPSE  5 
# define  V.ELLARC  6 
# define  V_ELLPIE  7 
# define  V_RBOX  8 
# define  V.RFBOX  9 
# define  V_ JUSTIFIED  10 

# define  V_EXIT_CUR  2 
# define  V_ENTER_CUR  3 
# define  V_F0RM_ADV  20 
# define  V_0UTPUT_WIND0W  21 
# define  V_CLEAR_DISP_LIST  22 
♦define  V_BIT_IMAGE  23 
♦define  V_ALPHA_TEXT  25 
♦define  V.TOPBOT  18501 

♦define  MAX_ALERT  3 

♦define  RSC.NAME  "SHOWGEM.RSC" 

♦ define  PATHSEP  'W 


♦define  DREADER  0x20 
♦define  DCHECKBOX  0x40 
♦define  DRBUTTON  0x60 


/»  Metafile  VDI  GDP  functions  */ 


/*  Metafile  VDI  ESC  functions  */ 


/*  Anzahl  Fehler  in  Resource  »/ 
/*  Name  der  Resource-Date i */ 


/*  user  defined  objects  */ 


♦define  ESC  27 

♦define  abs(x)  ((x)  < 0 ? -(x)  : (x))  /*  Absolut-Wert  »/ 

♦define  raax(x,y)  (((x)  > (y))  ? (x)  : (y))  /*  Maxlraim-Funktion  */ 

♦ define  min(x,y)  (((x)  < (y))  ? (x)  : (y))  /*  Minimum  Function  */ 

TYPES  / 

typedef  struct 

( 

WORD  bgc; 

WORD  style; 

WORD  interior; 

WORD  bdc; 
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WORD  width; 
WORD  chc; 

) OBINFO; 


typedef  struct  raeta_header 

( 

WORD  id; 

WORD  headlen; 

WORD  version; 

WORD  transform; 

WORD  min_x; 

WORD  min_y; 

WORD  raax_x; 

WORD  max_y; 

WORD  pwidth; 

WORD  pheight; 

WORD  ll_x; 

WORD  ll_y; 

WORD  ur_x; 

WORD  ur_y; 

WORD  bit_ image; 

) META_HEADER; 


typedef  struct  img_header 

( 

WORD  version; 

WORD  headlen; 

WORD  planes; 

WORD  pat_run; 

WORD  pix_width; 

WORD  pix_height; 

WORD  sl_width; 

WORD  sl_height; 

) IMG_HEADER; 


typedef  struct  rect 

WORD  x; 

WORD  y; 

WORD  w; 

WORD  h; 
j RECT; 
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typedef  struct  Irect 

[ 

LONG  x; 

LONG  y; 

LONG  w; 

LONG  h; 

) LRECT; 


typedef  struct  drect 

( 

DOUBLE  x; 

DOUBLE  y; 

DOUBLE  w; 

DOUBLE  h; 

] DRECT j 


typedef  struct  point 

WORD  x; 

WORD  y; 

) POINT; 


typedef  BYTE  STRING  [82]; 


/»***#*  VARIABLES  »»»**»»»*»»»»*»»*»»»»**»*»*»**»***»»***»*»**»*»»*» / 


#if  GEMDOS 
#if  MW_C 

LONG  _stkslze  = 12288;  /»  12  KBytes  Stack  fUr  Mark  Williams  C »/ 

#endlf 

#endlf 

#if  MSDOS 
#if  TURBO.C 

UWORD  _stklen  = 12288;  /»  12  KBytes  Stack  fUr  Turbo  C »/ 

#endif 

#endif 


#lf  DR_C  1 LASER_C  ! MW_C 

EXTERN  WORD  gl_apid;  /»  Identifikation  fUr  Appllkation  »/ 

#else 

GLOBAL  WORD  gl_apid;  /*  Identifikation  fQr  Appllkation  */ 

#endif 
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GLOBAL  WORD 

contrl  [12] ; 

/*  GEM  Arrays  fiir  Parameter...  */ 

GLOBAL  WORD 

Intln  [256]; 

/*  ...von  VDI  Aufrufen  */ 

GLOBAL 

WORD 

ptsln  [256] ; 

GLOBAL  WORD 

Intout  [256]; 

GLOBAL 

WORD 

ptsout  [256] ; 

LOCAL 

WORD 

n_pts; 

LOCAL 

WORD 

n_int; 

LOCAL 

LRECT 

out_device; 

LOCAL 

LRECT 

src; 

LOCAL 

LRECT 

dst; 

LOCAL 

DOUBLE 

dst_factor; 

/*  Faktor  zum  Einpassen  */ 

LOCAL 

DRECT 

aspect_factor; 

/»  Faktor  fQr  MaDstabstreue  */ 

LOCAL 

DRECT 

src_pixel; 

LOCAL 

LRECT 

dst_pixel; 

LOCAL 

POINT 

origo; 

LOCAL 

WORD 

work_in  [103]; 

LOCAL 

WORD 

work_out  [57]; 

LOCAL 

WORD 

vdi_handle; 

LOCAL 

WORD 

out_handle; 

LOCAL 

WORD 

phys_handle; 

LOCAL 

BYTE 

meta_nanie  [80] ; 

LOCAL 

ULONG 

meta_len; 

LOCAL 

DWORD 

meta_ Index; 

LOCAL 

DWORD 

)*meta_buffer; 

LOCAL 

META_HEADER  *raeta_header; 

LOCAL 

BYTE 

fs_llnpath  [128]; 

LOCAL 

BYTE 

fs.ilnsel  [13]; 

LOCAL 

WORD 

fs_lexbutton; 

LOCAL 

WORD 

more.fonts; 

LOCAL 

WORD 

gl_wbox,  gl_hbox, 

gl.wattr,  gl.hattr; 

LOCAL 

OBJECT 

^dialog; 

LOCAL 

OBJECT 

»userimg; 

LOCAL 

OBJECT 

^working; 

LOCAL 

BYTE 

»alerts  [MAX_ALERT];  /»  Fehlermeldungen  »/ 

LOCAL 

USERBLK 

check_blk; 

/»  Macintosh  check  boxes  */ 

LOCAL 

USERBLK 

radlo_blk; 

/*  Macintosh  radio  buttons  »/ 

/»»»*»»  PROTOTYPES  *»»»»»*»»»»***»»*»»»»»»»»»*»»»»***»»»***»»»»*»»»» / 

EXTERN 

VOID 

vdi  .((VOID)); 

#if  MSDOS 

EXTERN 

PARMBLK 

*fardr_start  .((VOID)); 
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EXTERN  VOID 
#endif 

fardr.end 

-((VOID)); 

#if  MSDOS 

LOCAL  WORD  CDECL 

draw_checkbox 

-((VOID)); 

LOCAL  WORD  CDECL 
#else 

draw.rbutton 

-((VOID)); 

LOCAL  WORD  CDECL 

draw.checkbox 

.((PARMBLK  *pb)); 

LOCAL  WORD  CDECL 
#endif 

draw_rbutton 

.((PARMBLK  »pb)); 

LOCAL  BOOLEAN 

file_exist 

.((STRING  filename)); 

LOCAL  WORD 

get_path 

.((STRING  path,  WORD  drive)); 

LOCAL  VOID 

set_cllp 

.((WORD  X,  WORD  y,  WORD  w,  WORD  h)); 

LOCAL  VOID 

set_ptext 

.((OBJECT  *tree,  WORD  obj, 
STRING  s)); 

LOCAL  VOID 

get_ptext 

.((OBJECT  »tree,  WORD  obj, 
STRING  s)); 

LOCAL  VOID 

do_state 

.((OBJECT  »tree,  WORD  obj, 
UWORD  state)); 

LOCAL  VOID 

undo_state 

.((OBJECT  »tree,  WORD  obj, 
UWORD  state)); 

LOCAL  VOID 

vdi_fix 

.((MFDB  *pfd,  VOID  »theaddr, 
WORD  wb,  WORD  h)); 

LOCAL  VOID 

vdi_trans 

.((WORD  »saddr,  WORD  swb, 

WORD  »daddr,  WORD  dwb,  WORD  h)); 

LOCAL  VOID 

trans_gimage 

.((OBJECT  »tree,  WORD  obj)); 

LOCAL  VOID 

get_obinfo 

.((LONG  obspec,  OBINFO  *obinfo)); 

LOCAL  VOID 

f ix_ob j s 

.((OBJECT  »tree)); 

LOCAL  BOOLEAN 

init_resource 

-((VOID)); 

LOCAL  WORD 

hndl_dial 

.((OBJECT  »tree,  WORD  def,  WORD  x, 
WORD  y,  WORD  w,  WORD  h)); 

LOCAL  VOID 

show_dial 

.((OBJECT  »tree)); 

LOCAL  VOID 

end_dlal 

.((OBJECT  »tree)); 

LOCAL  WORD 

open_work 

.((WORD  device)); 

LOCAL  VOID 

close_work 

.((WORD  device h 5 

LOCAL  BOOLEAN 

gdos_ok 

-((VOID)); 

LOCAL  VOID 

get_dev_lnfo 

.((WORD  vdi.handle)); 

LOCAL  VOID 

wait 

-((VOID)); 

LOCAL  VOID 

flip_word 

.((UBYTE  *adr)); 

LOCAL  BOOLEAN 

read_meta 

.((STRING  meta.name)); 

LOCAL  WORD 

get.word 

-((VOID)); 

LOCAL  BOOLEAN 

get_code 

-((VOID)); 

LOCAL  WORD 

new_width 

.((WORD  width)); 

LOCAL  WORD 

new_height 

.((WORD  height)); 

LOCAL  VOID 

transform 

.((BOOLEAN  flip_x,  BOOLEAN  flip.y)); 
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LOCAL 

BOOLEAN 

select.file 

LOCAL 

VOID 

get.header.info 

LOCAL 

VOID 

show.debug 

LOCAL 

VOID 

show.b it. image 

LOCAL 

VOID 

read_bit.image 

LOCAL 

VOID 

show.page 

LOCAL 

VOID 

do.command 

LOCAL 

VOID 

show.meta 

.((BYTE  *name,  BYTE  »suffix, 

BYTE  ^filename)); 

_( (BOOLEAN  best.f It) ) ; 

.((BOOLEAN  fllp.x,  BOOLEAN  flip_y))j 

. ( ( IMG.HEADER  * Img.header, 

UBYTE  »lmg.buffer, 

UBYTE  »raster.buf, 

UBYTE  *raster.ptr, 

UBYTE  »line.buf, 

LONG  l_buflen, 

UBYTE  »»plane.ptr, 

WORD  raax.lines, 

WORD  screen.planes , 

WORD  fww)); 

.((STRING  filename)); 

.((VOID)); 

.((WORD  device,  BOOLEAN  flip.x, 
BOOLEAN  flip.y)); 

.((WORD  device,  BOOLEAN  best.fit, 
BOOLEAN  usr.break) ) ; 


/»»»*»»  FUNCTIONS  / 


LOCAL  BOOLEAN  file.exist  (filename) 
STRING  filename; 


{ 

# if  GEMDOS 

return  (Fsflrst  (filename,  0x00)  ==  0); 
#else 

return  (Fsfirst  (filename,  0x00)  >0); 
#endif 

] /*  file.exist  */ 


LOCAL  WORD  get.path  (path,  drive) 
STRING  path; 

WORD  drive; 

{ 

BYTE  s [64],  sep  [2]; 

WORD  ret; 


path  [0]  = EOS; 
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ret  = Dgetpath  (s,  drive); 

if  (»s) 

( 

#if  MSDOS  1 FLEXOS 

strcpy  (path  +1,  s); 
path  [0]  = PATHSEP; 

#endif 

#if  GEMDOS 

strcpy  (path,  s) ; 

#endif 

] /»  if  */ 

sep  [0]  = PATHSEP; 
sep  [1]  = EOS; 

strcat  (path,  sep) ; 
return  (ret); 

) /*  get_path  */ 

/»»***»»»»»**»»»***»»**»**»»»»»»»**»»***»)(»»»»»***»»»»»»**»*»»*»»*»»/ 

LOCAL  VOID  set_clip  (x,  y,  w,  h) 

WORD  X,  y,  w,  h; 

[ 

WORD  pxy  [4]; 

pxy  [0]  = x; 

pxy  [1]  = y; 

pxy  [2]  = X + w - 1; 

pxy  [3]  = y + h - 1; 

vs_clip  (vdi_handle,  TRUE,  pxy); 

] /*  set_clip  */ 

/»»****»*»»«*»**»***»*»***»»**»»********»»***»***»»***»»»»»»»*»»»*»»/ 

LOCAL  VOID  set_ptext  (tree,  obj,  s) 

OBJECT  *tree; 

WORD  obj ; 

STRING  s; 
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[ 

TEDINFO  »ptedinfo; 

ptedlnfo  = (TEDINFO  *)tree  [obj] .ob_spec; 
strncpy  (ptedlnfo->te_ptext,  s,  ptedlnfo->te_txtlen  - 1); 
ptedlnfo->te_ptext  [ptedinfo->te_txtlen  - 1]  = EOS; 
j /*  set_ptext  */ 

LOCAL  VOID  get_ptext  (tree,  obj,  s) 

OBJECT  *tree; 

WORD  obj ; 

STRING  s; 

( 

TEDINFO  »ptedinfo; 

ptedlnfo  = (TEDINFO  »)tree  [obj] .ob_spec; 
strcpy  (s,  ptedinfo->te_ptext) ; 

) /*  get_ptext  */ 

/*»»«»»»»*»»*»»»*»»»*»»**»*****»**»»*»»*»*»»»»»»»»***»********»»*»»»/ 

LOCAL  VOID  do_state  (tree,  obj,  state) 

OBJECT  »tree; 

WORD  obj ; 

DWORD  state; 

( 

tree  [obj] .ob_state  1=  state;  /*  Status  Im  Objekt  setzen  */ 

) /*  do.state  */ 

/»*»*»*«»*»»»»»»»»»»»»«»»»»»»***»»»*»»»**»»*»»*»**»»*»»****»**»»»***/ 

LOCAL  VOID  undo.state  (tree,  obj,  state) 

OBJECT  *tree; 

WORD  obj ; 

DWORD  state; 

( 

tree  [obj] .ob_state  &=  - state;  /♦  Status  im  Objekt  ISschen  */ 

] /*  undo_state  */ 
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LOCAL  VOID  vdi_fix  (pfd,  theaddr,  wb,  h) 
MFDB  *pfd; 

VOID  *theaddr; 

WORD  wb,  h; 


( 

pfd->mp  = theaddr; 
pfd->fwp  = wb  « 3; 

pfd->fh  = h;  •• 

pfd->fww  = wb  » 1; 
pfd->np  = 1; 

] /*  vdi_fix  »/ 

/*»»»»»»**»*»»»*«**»»»***»**»»»***»»»***»»»»»»»»»»»**»»**»»**»*»»*»*/ 

LOCAL  VOID  vdi_trans  (saddr,  swb,  daddr,  dwb,  h) 

WORD  * saddr; 

WORD  swb; 

WORD  » daddr; 

WORD  dwb; 

WORD  h; 


[ 

MFDB  src,  dst; 

vdl_fix  (&src,  saddr,  swb,  h); 
src.ff  = TRUE; 

vdl_flx  (&dst,  daddr,  dwb,  h); 
dst.ff  = FALSE; 

vr_tmfm  (vdi_handle,  &src,  &dst); 

) /*  vdi_trans  */ 

/»**»»»*****»»»»»»»»»»**»»»»»»»*»»»»»**»»»*»»»**»»»»***»*****»»»»*»*/ 

LOCAL  VOID  trans_gimage  (tree,  obj) 

OBJECT  »tree; 

WORD  obj ; 

( 

ICONBLK  *plconbllc; 

BITBLK  »pbitblk; 

WORD  *taddr; 

WORD  wb,  hi,  type; 
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type  = tree  [obj] .ob_type; 

if  (type  ==  G.ICON) 

( 

plconbllc  = (ICONBLK  *)tree  [obj]  .ob_spec; 
taddr  = piconbIk->ib_pmask; 
wb  = piconblk->ib.wlcon; 

wb  = wb  » 3; 

hi  = piconblk->ib_hicon; 

vdl_trans  (taddr,  wb,  taddr,  wb,  hi); 

taddr  = plconbIk->ib_pdata; 

] /*  if  */ 
else 

pbltbllc  = (BITBLK  *)tree  [obj]  .ob_spec; 
taddr  = pbitblk->bi_pdata; 
wb  = pbltblk->bl_wb; 
hi  = pbitblk->bi_hl; 

] /*  else  */ 

vdl_trans  (taddr,  wb,  taddr,  wb,  hi); 

) /*  trans.gimage  */ 

/**»**»»»*»»***»»**»»»**»»»**»»*»»»*»»»»*»»»*»*»»»»*»»»»***»»»»*»»»»/ 

LOCAL  VOID  get_oblnfo  (obspec,  oblnfo) 

LONG  obspec; 

OBINFO  »oblnfo; 

( 

WORD  colorwd; 

colorwd  = (WORD) obspec; 

obinfo->bgc  = colorwd  & OxOF; 
obinfo->style  = (colorwd  & 0x70)  » 4; 

if  (obinfo->style  ==  0) 
ob inf o-> inter lor  = 0; 
else 

if  (obinfo->style  ==  7) 
ob inf o-> inter lor  = 1; 
else 

obinfo-> Interior  = (colorwd  & 0x80)  ? 3 : 2; 
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obinfo->bdc  = (colorwd  & OxFOOO)  » 12; 
oblnfo->wldth  = (WORD) (obspec  » 16)  & OxFF; 

if  (oblnfo->wldth  > 127)  obinfo->width  = 256  - oblnfo->wldth; 

oblnfo->chc  = (colorwd  & OxOFOO)  » 8j 
) /*  get_obinfo  */ 

/*  Zelchnet  ankreuzbare  Buttons  */ 

/**»»»*»**»*»*»*»»»»»»»»»»*»*»»*»»»«*»»»**»»***»****»*»»»*»»*»»*»»»»/ 


#lf  MSDOS 

LOCAL  WORD  CDECL  draw.checkbox  () 

( 

PARMBLK  *pb; 

#else 

LOCAL  WORD  CDECL  draw_checkbox  (pb) 
PARMBLK  »pb; 


( 

#endif 

LONG  ob.spec; 

WORD  ob_x,  ob_y,  ob_width,  ob_height; 

BOOLEAN  selected,  changed; 

WORD  pxy  [10] ; 

OBINFO  Ob info; 


#if  MSDOS 
pb  = fardr_start() ; 
#endif 


ob_spec 

ob_x 

ob_y 

ob.width 

ob_height 

selected 

changed 


pb->pb_parm; 

pb->pb_x; 

pb->pb_y; 

pb->pb_w; 

pb->pb_h; 

pb->pb_currstate  & SELECTED; 

(pb->pb_currstate  ^ pb->pb_prevstate)  & SELECTED; 


get_obinfo  (ob_spec,  &obinfo); 

set_clip  (pb->pb_x,  pb->pb_y,  pb->pb_w,  pb->pb_h); 
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vsl_type  (vdi_handle,  FIS_SOLID); 
vsl_ends  (vdi_handle,  SQUARED,  SQUARED); 
vsl_width  (vdi_handle,  1); 
vsl_color  (vdi_handle,  obinfo.bdc); 
vswr_mode  (vdl_handle,  MD_REPLACE); 


if  (! 

( 

pxy 

pxy 

pxy 

pxy 

pxy 

pxy 

pxy 

pxy 

pxy 

pxy 


changed)  /*  it  was  an  obJc_draw,  so  draw  box  */ 


[0] 

= 

ob_x; 

[1] 

= 

ob_y; 

[2] 

ob_x  + ob_width  - 

[3] 

= 

ob_y; 

[4] 

= 

pxy  [2]; 

[5] 

ob_y  + ob_height  - 

[6] 

= 

ob_x; 

[7] 

= 

pxy  [5]; 

[8] 

= 

ob_x; 

[9] 

= 

ob_y; 

v_pllne  (vdi_handle,  5,  pxy); 
j /*  if  */ 


if  (selected)  /*  it  was  an  objc_change  */ 
vsl_color  (vdi.handle,  obinfo.bgc); 
else 

vsl_color  (vdi_handle,  WHITE); 


set_clip  (ob_x  + 1,  ob_y  + 1,  ob_width  - 2,  ob_height  - 2); 

pxy  [0]  = ob_x; 

pxy  [1]  = ob_y; 

pxy  [2]  = ob_x  + ob.width  - 1; 

pxy  [3]  = ob_y  + ob_height  - 1; 

v_pline  (vdi_handle,  2,  pxy); 

pxy  [0]  = ob_x  + ob_width  - 1; 

pxy  [1]  = ob_y; 

pxy  [2]  = ob_x; 

pxy  [3]  = ob_y  + ob_height  - 1; 

v.pline  (vdi_handle,  2,  pxy); 


#if  MSDOS 
f ardr_end  ( ) ; 
#endif 
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return  (pb->pb_currstate  & -SELECTED) ; 

] /*  draw_checkbox  */ 

/ JHHHHHHHHt  **»*»»*  iHHHHHHHHHHHHHHHHHHHt  *»»»*»**»»»*»»»*»»»»»»*»»»»»»»»  / 

/>  Zeichnet  runde  Radiobuttons  */ 

/)(****»*»»*»»»»»»*»»»»»»*»»»#*»»»#*»»****)(»*«*»*»**»**»»»»«»*»*»»*»»/ 


#lf  MSDOS 

LOCAL  WORD  CDECL  draw.rbutton  () 

[ 

PARMBLK  *pb; 

#else 

LOCAL  WORD  CDECL  draw_rbutton  (pb) 
PARMBLK  »pb; 


( 


#endlf 

LONG 

ob_spec ; 

WORD 

ob_x,  ob_y; 

BOOLEAN 

selected; 

MFDB 

s,  d; 

BITBLK 

»bitblk; 

WORD 

robj;  /*  radio  button  object  number  */ 

WORD 

pxy  [8]; 

WORD 

index  [2] ; 

OBINFO 

oblnfo; 

#if  MSDOS 
pb  = fardr_start() ; 

#endif 

ob_spec  = pb->pb_parm; 

ob_x  = pb->pb_xj 

ob_y  = pb->pb_y; 

selected  = pb->pb_currstate  & SELECTED; 

get_obinfo  (ob_spec,  &obinfo); 

set_clip  (pb->pb_x,  pb->pb_y,  pb->pb_w,  pb->pb_h) ; 

if  (selected)  /*  it  was  an  objc_change  */ 
robj  = (gl_hbox  > 8)  ? RBHSEL  : RBLSEL;  /»  high  res: low  res  */ 
else 

robj  = (gl_hbox  > 8)  ? RBHNORM  : RBLNORM;  /*  high  res: low  res  »/ 
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bltblk  = (BITBLK  »)userlmg  [robj] .ob_spec; 

d.mp  = NULL;  /*  screen  */ 

s.mp  = (VOID  *)bitblk->bi_pdata; 

s.fwp  = bitblk->bl_wb  « 3> 

s.fh  = bitblk->bi_hl; 

s.fww  = bitblk->bi_wb  » 1; 

s.ff  = FALSE; 

s.np  =1; 

pxy  [0]  = 0; 

pxy  [1]  =0; 

pxy  [2]  = s.fwp  - 1; 

pxy  [3]  = s.fh  - 1; 

pxy  [4]  = ob_x; 

pxy  [5]  = ob_y; 

pxy  [6]  = ob_x  + pxy  [2]; 

pxy  [7]  = ob_y  + pxy  [3]; 

Index  [0]  = obinfo.bgc; 
index  [1]  = WHITE; 

vrt.cpyfm  (vdi.handle,  MD_REPLACE,  pxy,  &s,  8cd,  index); 

#if  MSDOS 
fardr_end  (); 

#endif 

return  (pb->pb_currstate  & -SELECTED); 

) /*  draw.rbutton  */ 

LOCAL  VOID  fix_objs  (tree) 

OBJECT  *tree; 


WORD 

obj,  robj; 

OBJECT 

*ob; 

ICONBLK 

»ib; 

BITBLK 

*bi; 

WORD 

w_desire,  h_desire 

WORD 

x_corr,  y_corr,  w_( 

WORD 

y_radio,  h.radio; 

BOOLEAN 

hires; 

DWORD 

xtype; 
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hires  = (gl_hbox  > 8)  ? TRUE  : FALSE; 
w_deslre  = 12; 

h_deslre  = hires  ? 12  : 6;  /*  ensures  that  boxes  are  square  */ 

x_corr  = (2  * gl_wbox  - w_desire)  / 2; 

y_corr  = (gl_hbox  - h_desire)  / 2; 
w.corr  = -2  * x_corr; 

h_corr  = -2  * y_corr; 

robj  = hires  ? RBHNORM  : RBLNORM; 

hi  = (BITBLK  *)userimg  [robj] .ob_spec; 

y_radio  = hires  ? y_corr  : 0; 
h_radio  = bi->bi_hl; 

check_bll£.ub_code  = draw_  checkbox; 
radio_blk.ub_code  = draw_rbutton; 

if  (tree  !=  NULL) 

[ 

obj  = NIL; 

do 

( 

ob  = &tree  [++obj]; 

if  (ob->ob_type  ==  G_IC0N) 

( 

ib  = (ICONBLK  *)ob->ob_spec;  /*  Objekthdhe  = */ 

ob->ob_height  = ib->ib_ytext  + ib->ib_htext;  /*  IconhShe  */ 
trans_gimage  (tree,  obj);  /*  Icons  an  Bildschirm  anpassen  */ 
) /*  if  */ 

if  (ob->ob_type  ==  G_IMAGE) 

{ 

bi  = (BITBLK  *)ob->ob_spec; 

ob->ob .height  = bi->bi_hl;  /*  ObjekthShe  = IraagehShe  »/ 

trans.gimage  (tree,  obj);  /*  Bitimgs  an  Bildsch.  anpassen  */ 
) /*  if  */ 

xtype  = ob->ob_type  » 8; 
switch  (xtype) 

case  DREADER  : ob->ob_y  -=  gl_hbox  / 2; 
break; 
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case  DCHECKBOX 


case  DRBUTTON 


) /*  switch  */ 
j while  (!  (ob->ob 
j /«  if  */ 

] /*  fix_obJs  */ 


: check_b Ik . ub_parm 
ob->ob_x 
ob->ob_y 
ob->ob_width 
ob->ob_height 
ob->ob_type 
ob->ob_spec 
break; 

: radio_blk.ub_parm 
ob->ob_y 
ob->ob_height 
ob->ob_type 
ob->ob_spec 
break; 

flags  & LASTOB)); 


= ob->ob_spec; 

+=  x_corr; 

+=  y_corr; 

+=  w_corr; 

+=  h_corr; 

= G_USERDEF; 

= (LONG)&check_blk; 

= ob->ob_spec; 

+=  y_radio; 

= h_radio; 

= G_USERDEF; 

= (LONG)&radio_blk; 


/*»*»*»»»»*»**»»»*»»»»»»»»»**»»»*»»»**»»**»»***»»»*»*»»»»*»*»»»**»*»/ 
LOCAL  BOOLEAN  init_resource  () 

[ 

WORD  i; 

STRING  s; 

if  (!  rsrc_load  (RSC.NAME)) 

{ 

strcpy  (s,  "[3] [Resource-File  1 ") > 
strcat  (s,  RSC_NAME) ; 
strcat  (s,  "?][  EXIT  ]"); 
fornualert  (1,  s); 
return  (FALSE); 
j /*  if  »/ 

if  (gl_hbox  > 8)  /*  high  resolution  */ 
rsrc.gaddr  (R_TREE,  DIALOGH,  Sedialog) ; 
else 

rsrc_gaddr  (R_TREE,  DIALOGL,  Sedialog) ; 

rsrc_gaddr  (R_TREE,  USERIMG,  Scuserirag) ; 
rsrc.gaddr  (R_TREE,  WORKING,  Scworking); 

for  (i  = 0;  i < MAX_ALERT;  i++) 
rsrc_gaddr  (R_STRING,  i,  Sealerts  [i]); 
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flx_objs  (dialog); 
fix_objs  (userlmg); 
flx_objs  (working); 

#if  GEM  & (GEM2  I GEM3  ! XGEM) 
undo_state  (dialog,  ROOT,  SHADOWED); 
do.state  (dialog,  ROOT,  OUTLINED); 
#endif 

do_state  (dialog,  DSCREEN,  SELECTED); 
do.state  (dialog,  SBESTFIT,  SELECTED); 
return  (TRUE) ; 

] /*  init_resource  »/ 


LOCAL  WORD  hndl_dial  (tree,  def,  x,  y,  w,  h) 

OBJECT  *tree; 

WORD  def; 

WORD  X,  y,  w,  h; 

[ 

WORD  xdial,  ydial,  wdial,  hdial; 

WORD  exit_obJ ; 

form_center  (tree,  &xdial,  &ydial,  &wdial,  &hdial); 
form_dial  (FMD_START,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 
form_dial  (FMD_GR0W,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 

objc_draw  (tree,  ROOT,  MAX_DEPTH,  xdial,  ydial,  wdial,  hdial); 
exit_obj  = form_do  (tree,  def)  & 0x7FFF; 

fortiLdial  (FMD.SHRINK,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 
form_dial  (FMD_FINISH,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 

undo.state  (tree,  exit_obj,  SELECTED); 

return  (exit_obj);  /*  Objekt,  mit  dera  Dialogbox  verlassen  wurde  */ 
) /*  hndl.dial  »/ 


LOCAL  VOID  show_dial  (tree) 
OBJECT  *tree; 
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{ 

WORD  xdial,  ydial,  wdial,  hdial; 

WORD  X,  y,  w,  h; 

x = y = w = h = 0; 

forra_center  (tree,  &xdial,  &ydial,  &wdlal,  &hdlal) ; 
form_dlal  (FMD_START,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 
form_dlal  (FMD_GR0W,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 

objc_draw  (tree,  ROOT,  MAX_DEPTH,  xdial,  ydial,  wdial,  hdial); 
] /*  show_dial  */ 

LOCAL  VOID  end_dial  (tree) 

OBJECT  *tree; 


{ 

WORD  xdial,  ydial,  wdial,  hdial; 

WORD  X,  y,  w,  h; 

x = y = w = h = 0; 

form_center  (tree,  &xdial,  &ydial,  &wdial,  Sehdial); 
form_dial  (FMD_SHRINK,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 
forra_dial  (FMD.FINISH,  x,  y,  w,  h,  xdial,  ydial,  wdial,  hdial); 
j /*  end_dial  »/ 

LOCAL  WORD  open_work  (device) 

WORD  device; 

[ 

WORD  i; 

WORD  handle; 

for  (i  = 0;  1 < 103;  1++)  work_ln  [i]  = 1; 

work_ln  [0]  = device;  /*  device  handle  */ 

work_ln  [10]  = RC;  /*  Raster  Koordinaten  */ 
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if  (device  ==  SCREEN) 

{ 

handle  = phys_handle; 

v.opnvwk  (work_in,  &handle,  work.out);  /*  virtuell  dffnen  */ 

) /*  if  »/ 

else  /*  nicht  Bildschirm  */ 

[ 

work_in  [11]  = OW.NOCHANGE;  /*  parallel  or  serial  port  */ 

v_opnwk  (work_in,  Schandle,  work_out);  /*  physikalisch  offnen  */ 

) /*  else  */ 

out_device.x  = 0; 

out_ device. y = 0; 

out_device,w  = work_out  [0]  + IL; 

out_device.h  = work_out  [1]  + IL; 

dst_pixel.w  = work_out  [3]; 
dst_pixel.h  = work_out  [4]; 

return  (handle) ; 
j /*  open_work  */ 

LOCAL  VOID  close_work  (device) 

WORD  device; 


switch  (device) 

case  SCREEN  : v_clsvwk  (out_handle) ; break; 
case  PLOTTER  : 

case  PRINTER  : v_clswk  (out_handle) ; break; 

) /»  switch  */ 

] /*  close.work  */ 

/»»*»»»»»»***»»*»»*»***»»**»»»*»*»**»»»*»*»*»»»»»»»*»»**»*»»**»»*»»*/ 
LOCAL  BOOLEAN  gdos.ok  () 

[ 

#if  GEMDOS 
#if  TURBO.C 1 LASER_C 
return  (vq_gdos  ()); 

#else 

return  (TRUE) ; 

#else 
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#endlf  /*  TURBO.C  */ 

#else 

return  (TRUE); 

#endlf  /*  GEMDOS  */ 

] /»  gdos_ok  */ 

/»»*»***«**«»*»»***»»»*»»*»****»»»»»»»*»*»»#**»»*«*»»»****»»*#»»»»**/ 

LOCAL  VOID  get_dev_lnfo  (vdi_handle) 

WORD  vdi_handle; 


{ 

vq_extnd  (vdl_handle,  FALSE,  work_out); 

out.device.x  = 0; 

out_ device. y = 0; 

out_device.w  = work_out  [0]  + IL; 

out_device.h  = work_out  [1]  + IL; 

dst_plxel.w  = work_out  [3]; 
dst_plxel.h  = work_out  [4]; 

] /»  get_dev_lnfo  */ 

/»»»*»**»**»*»»*«»»#*»»*»»»»***»»**»»***»»#*»»»***»»»»****»*»»»*»*»*/ 
LOCAL  VOID  wait  () 

{ 

WORD  msgbuf  [8] ; 

WORD  1; 

UWORD  u; 

evnt_multl  (MU_KEYBD  + MU.BUTTON, 

1,  1,  1,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0, 

msgbuf,  0,  0,  &i,  &i,  &i,  &i,  &u,  &i) ; 

) /»  wait  »/ 

/*»»»*»***»»»»*»**»»»»»»**«»***»»***»»»»»»*»»***»»*»»**»*«»»»»**»»»»/ 

LOCAL  VOID  flip.word  (adr) 

REG  UBYTE  »adr; 

( 


REG  UBYTE  c; 
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c = adr  [0]; 

adr  [0]  = adr  [1]; 

adr  [1]  = c; 

} /*  flip_word  »/ 

/»**»)(»»»***»»»»***»»*#*»»****»»»*»»***»»»**»»»*»»»»*»»»*»»*»»*»»»»»/ 

LOCAL  BOOLEAN  read_raeta  (meta_name) 

STRING  raeta_name; 


{ 

WORD  handle; 

WORD  1; 

BOOLEAN  ok; 

ok  = FALSE; 

handle  = Fopen  (meta_name,  0); 

if  (handle  >=  0) 

{ 

raeta_len  = Fseek  (OL,  handle,  2); 
meta_buffer  = (DWORD  »)Malloc  (raeta_len); 

Fseek  (OL,  handle,  0); 

if  (meta_buffer  ==  NULL) 

form_alert  (1,  alerts  [NOMEMORY]); 
else 

meta_len  = Fread  (handle,  meta_len,  raeta_buf fer) ; 
#if  M68000 

for  (i  = 0;  i < meta_len  / 2;  i-H-) 

flip.word  ((UBYTE  »)8eineta_buffer  [i]); 

#endif 

meta_header  = (META_HEADER  *)meta_buffer; 
meta_ index  = meta_header->headlen; 

ok  = TRUE; 

) /*  else  */ 

Fclose  (handle) ; 

) /*  if  */ 
else 

fomualert  (1,  alerts  [NOFILE]); 
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return  (ok); 

] /*  read_meta  */ 

/**»*»»«»»»»*»*»*»»*****»»**»*»»**»***»»»*»»»»**»»»»*»»»***»»»»*»*»»/ 
LOCAL  WORD  get.word  () 

[ 

return  (meta_buffer  [meta_lndex++]) ; 

) /*  get_word  */ 

LOCAL  BOOLEAN  get.code  () 

[ 

WORD  i; 

contrl  [0]  = get_word  (); 

if  (contrl  [0]  ==  -1)  return  (FALSE); 

contrl  [1]  = get_word  (); 

contrl  [3]  = get_word  (); 

contrl  [5]  = get_word  (); 

contrl  [6]  = out_handle; 

n_pts  = contrl  [1]  * 2; 
n_int  = contrl  [3] ; 

for  (i  = 0;  i < n_pts;  i-H-)  ptsln  [1]  = get_word  (); 
for  (i  = 0;  1 < n_int;  i++)  intln  [1]  = get_word  (); 

return  (TRUE); 

] /*  get_code  */ 

LOCAL  WORD  new.wldth  (width) 

WORD  width; 

{ 

width  = width  * dst_f actor  * aspect_f actor. w; 
if  (width  ==  0)  width  = 1; 

return  (width); 

) /»  new.width  »/ 


/»*»»»»»*»»*»»*»»*»»»**»*»*»****»»»»»»»**»»»**»»****»»***»»»****»*»*/ 
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LOCAL  WORD  new.height  (height) 

WORD  height; 

{ 

height  = height  * dst_factor  * aspect_f actor. h; 
if  (height  ==  0)  height  = 1; 

return  (height); 

] /*  new_height  */ 

/***»***»»»»*»»»»»*»**»»»*»»»»*******»***»*****»****»»*»»*****»**»*»/ 

LOCAL  VOID  transform  (flip_x,  flip_y) 

BOOLEAN  flip_x,  flip_y; 

[ 

WORD  i,  ix,  iy,  x,  y; 

WORD  gdp,  n; 

BOOLEAN  special; 

for  (i  = 0;  i < contrl  [1];  i++) 

ix  = 2 » i; 
iy  = ix  + 1; 

if  (contrl  [0]  ==  V_GDP) 

[ 

gdp  = contrl  [5] ; 
n = -1; 

switch  (gdp) 

( 

case  V_ARC  : 

case  V_PIESLICE  : n = 3;  break; 

case  V_CIRCLE  : n = 2;  break; 

case  V.ELLIPSE 

case  V_ELLARC  : 

case  V_ELLPIE 

case  V.JUSTIFIED  : n = 1;  break; 

case  V_BAR  : 

case  V_RB0X 

case  V_RFB0X  ; n = -1;  break; 

j /*  switch  »/ 

special  = (i  ==  n);  /*  Radius,  LSnge  */ 

] /»  if  */ 
else 
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( 

gdp  = 0; 

special  = FALSE; 
j /*  else  »/ 


if  (special) 


switch  (gdp) 

( 

case  V_ARC 
case  V_PIESLICE 
case  V.CIRCLE 

case  V_ELLIPSE 
case  V_ELLARC 
case  V_ELLPIE 


case  V.JUSTIFIED  : 


/»  Radius  */ 

ptsln  [ix]  = ptsin  [ix]  * dst.w  / 
break; 

/*  Transformlere  x-  und  y-Radius 

ptsln  [lx]  = ptsln  [ix]  * dst.w  / 
ptsln  [iy]  = ptsln  [ly]  * dst.h  / 
break; 

ptsin  [lx]  = ptsln  [lx]  * dst.w  / 
break; 


j /*  switch  »/ 

) /»  If  »/ 

else  /»  Blldschirmpunkte  */ 

I 

ptsin  [ix]  -=  origo.x; 
ptsln  [iy]  -=  orlgo.y; 


X = ptsln  [ix]  * dst.w  / src.w; 
y = ptsin  [iy]  » dst.h  / src.h; 


if  (fllp_x) 

ptsin  [lx]  = dst.x  + dst.w  - x; 
else 

ptsin  [ix]  = dst.x  + x; 


if  (fllp_y) 

ptsln  [iy]  = dst.y  + dst.h  - y; 
else 

ptsln  [iy]  = dst.y  + y; 

] /»  else  */ 

] /»  for  */ 

) /*  transform  */ 


src.w; 

V 

src.w; 

src.h; 

src.w; 


/»*»*»**»»»»»»*»»*«*»»*»»**»***»»»*»»»»***»*»*»»*»»»»***»*«**»»*»»»»/ 
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LOCAL  VOID  get_header_info  (best_flt) 
BOOLEAN  best_fit; 


[ 

DOUBLE  x_factor,  y_factor; 


if  (meta_header->ll_x  !=  0 
meta_header->ll_y  !=  0 
meta_header->ur_x  !=  0 
meta_header->ur_y  !=  0) 


{ 

src.x 

src.y 

src.w 

src.h 


rain  (meta_header->ll_x,  raeta_header->ur_x) ; 
rain  (raeta_header->ll_y,  raeta_header->ur_y) ; 
abs  ((LONG)meta_header->ur_x  - 

(LONG)raeta_header->ll_x)  + 1; 
abs  ((LONG)meta_header->ur_y  - 

(LONG)raeta_header->ll_y)  + 1; 


if  (raeta_header->pwidth  !=  0 ! I /*  page  width/height  */ 
raeta_header->pheight  !=  0) 

{ 

src_pixel.w  = (DOUBLE)raeta_header->pwidth  * lOOL  / src.w; 
src.pixel.h  = (DOUBLE)raeta_header->pheight  * lOOL  / src.h; 

aspect_f actor. w = src.pixel.w  / dst_pixel.w; 
aspect_factor.h  = src_pixel.h  / dst_pixel.h; 
j /*  if  */ 

raeta_header->transforra  = (raeta_header->ll_y  >0)  ? RC  : NDC; 
origo.x  = raeta_header->ll_x; 


if  (raeta_header->transforra  ==  NDC) 
origo.y  = -raeta_header->ll_y; 
else 

origo.y  = raeta_header->ur_y; 
j /*  if  */ 

if  (raeta_header->pwidth  !=  0 II  /*  page  width/height  */ 
raeta_header->pheight  !=  0) 

( 

dst.x  = 0; 

dst.y  = 0; 

dst.w  = raeta_header->pwidth  * lOOL  / dst_pixel.w; 

dst.h  = raeta_header->pheight  * lOOL  / dst_pixel.h; 
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x_factor  = (DOUBLE)out_device.w  / dst.w; 
y_factor  = ( DOUBLE) out_devlce .h  / dst.h; 

if  (best_f it)  dst_factor  = min  (x^factor,  y_factor) j 

dst.w  = dst.w  * dst_factor; 
dst.h  = dst.h  * dst_f actor; 

dst.x  = (out_device.w  - dst.w)  / 2;  /*  center  picture  */ 
dst.y  = (out_device.h  - dst.h)  / 2; 

] /*  if  */ 

] /*  get_header_info  */ 

/**»»x»»***»»xx****xx*»xxx*»#»********it**x******x»»**xx*x»**»#***«**/ 

LOCAL  VOID  show.debug  (flip_x,  flippy) 

BOOLEAN  flip_x,  fllp_y; 

( 

v_enter_cur  (phys_handle) ; 

printf  ("src:  x = ^51d,  y = ?551d,  w = 5?51d,  h = 5?51d\n", 
src.x,  src.y,  src.w,  src.h); 

printf  ("dst;  x = ^51d,  y = ;?51d,  w = %^ld,  h = ^51d\n", 
dst.x,  dst.y,  dst.w,  dst.h); 

printf  ("out:  x = ^51d,  y = %51d,  w = ^51d,  h = ^51d\n", 
out_device.x,  out_device.y,  out_device.w,  out.device.h) ; 
printf  ("origo:  x = %d,  y = ^d\n",  origo.x,  origo.y); 
printf  ("flip  : x = ^d,  y = J5d\n",  flip_x,  flip_y) ; 
printf  ("more_fonts  = ^d\n",  more.fonts); 
printf  ("dst_f actor  = iSlAn",  dst_f actor); 
printf  ("aspect_factor:  w = ^If,  h = %lf\n", 
aspect. f actor. w,  aspect.factor.h) ; 
printf  ("sre_pixel  : w = ^lf/1000  mm,  h = %lf/1000  mm\n", 
src.pixel.w,  src.pixel.h) ; 

printf  ("dst.pixel  : w = 5Sld/1000  mm,  h = ?ld/1000  mm\n", 
dst.pixel.w,  dst.pixel.h) ; 
printf  ("Mavail  : ^ld\n",  Mavail  ()); 

wait  0; 

v.exit^cur  (phys_handle) ; 
v.clrwk  (phys.handle) ; 

] /*  show.debug  */ 

/**X;tX»*X*JHt#^Ht»»**»****»»*X****»******1H(*******X»»»»*X*X»»«»X******/ 

LOCAL  VOID  show_bit_iraage  (img.header,  img.buffer,  raster.buf, 

raster.ptr,  line.buf,  l.buflen, 
plane_ptr,  max_lines,  screen.planes,  fww) 
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IMG_HEADER 

UBYTE 

UBYTE 

UBYTE 

UBYTE 

LONG 

UBYTE 

WORD 

WORD 

WORD 


*img_header; 

*img_buffer; 

*raster_buf ; 

»raster_ptr; 

*line_buf; 

l_buflen; 

*»plane_ptr; 

max_lines; 

screen_planes; 

fww; 


UBYTE  »lmg_ptr; 

UBYTE  »line_ptr; 

WORD  vrc;  /*  vertical  replication  count  »/ 

WORD  bytecols;  /*  counter  for  planedata  ♦/ 

UBYTE  data;  /*  one  byte  of  pixel  data  */ 
UBYTE  pattern  [MAX_PATTERNS] ; 

WORD  ■ max_pattern; 

UWORD  length; 

WORD  index  [2] ; 

WORD  idx,  count; 

WORD  i,  line; 

WORD  plane; 

WORD  fwb; 

MFDB  s,  d; 

WORD  pxy  [8] ; 

WORD  segments ; 


s.mp  = d.mp  = 
s.fwp  = d.fwp  = 
s.fh  = d.fh  = 
s.fww  = d.fww  = 
s.ff  = d.ff  = 
s.np  = d.np  = 


(VOID  *)raster_buf; 
fww  » 16; 
max_lines; 
fww; 

TRUE;  /*  standard  format  */ 
screen_planes; 


fwb  = fww  * 2; 


pxy 

[0] 

= 0; 

pxy 

[1] 

= 0; 

pxy 

[2] 

= s.fwp  - 1; 

pxy 

[3] 

= s.fh  - 1; 

pxy 

[4] 

= (out_device.w 

- pxy 

[2]  ■ 

- 1) 

/ 2; 

/* 

center  picture 

»/ 

pxy 

[5] 

= (out_device.h 

- pxy 

[3]  • 

- 1) 

/ 2; 

/* 

center  picture 

*/ 

pxy 

[6] 

= pxy  [4]  + pxy 

[2]; 

pxy 

[7] 

= pxy  [5]  + pxy 

[3]; 

vs.clip  (out_handle,  TRUE,  &pxy  [4]); 
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index  [0]  = BUCK; 
index  [1]  = WHITE; 

line  = 0; 

max_pattern  = min  (img_header->pat_run,  MAX_PATTERNS) ; 
img_ptr  = img_buffer  + img_header->headlen  * 2; 
segments  = 1 + img_header->sl_height  / (max_lines  + 1) ; 

while  (line  < max_lines) 
vrc  = 1; 

for  (plane  = 0;  plane  < img_header->planes ; plane++) 

( 

bytecols  = l_buflen; 
line_ptr  = line_buf; 

while  (bytecols  > 0) 
data  = *img_ptr++; 

switch  (data) 

( 

case  0 : /»  vertical  replication  count  or  pattern  run  */ 

data  = *img_ptr++; 

if  (data  ==  0)  /*  vertical  replication  count  »/ 

[ 

if  (»img_ptr++  ==  OxFF)  vrc  = »img_ptr-H-; 
j /»  if  »/ 

else  /»  pattern  run  */ 

{ 

bytecols  -=  data  * img_header->pat_run; 
for  (1=0;  i < max_pattern;  i++) 
pattern  [i]  = img_ptr  [i]; 
img_ptr  +=  irag_header->pat_run; 

while  (data  > 0) 

( 

for  (i  = 0;  i < max_pattem;  i-H-) 
»line_ptr++  = pattern  [i]; 
data — ; 

) /*  while  »/ 

] /*  else  »/ 
break; 
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case  0x80  : /*  bit  string 

data  = *lmg_ptr-H-; 
bytecols  -=  data; 

while  (data  > 0) 

( 

*line_ptr++  = *img_ptr++; 
data — ; 

] /*  while  »/ 
break; 

default  : /*  solid  run  */ 

length  = data  & 0x7F; 

bytecols  -=  length; 

data  = (data  & 0x80)  ? OxFF  : 0; 

while  (length  > 0) 

( 

*line_ptr++  = data; 
length — ; 

] /*  while  */ 
break; 

) /*  switch  »/ 

] /*  while  */ 

#if  18086  /»  flip  words  »/ 

for  (i  = 0;  i < l_buflen  / 2;  i++) 
flip.word  (&line_buf  [i  * 2]); 

#endif 

idx  = plane  % screen_planes; 

raster_ptr  = plane_ptr  [ idx] ; 

for  (count  = 0;  count  < vrc;  count++) 

[ 

line_ptr  = line_buf; 

for  (i  = 0;  i < l_buflen;  i++)  ^^raster_ptr-H•  !=  »line_ptr++; 
) /»  for  */ 

) /»  for  */ 

for  (i  = 0;  i < screen_planes;  i++)  plane_ptr  [i]  +=  vrc  * fwb; 
line  +=  vrc; 

) /*  while  */ 


vr_trnfm  (out_handle,  &d,  &s); 
d.mp  = NULL;  /»  screen  */ 


4.2  Erlduterungen  zum  Programm  SHOWGEM 


273 


if  ( img_header->planes  ==  1)  /*  Quellbild  in  monochrom  zeichnen  */ 
vrt_cpyfra  (vdi_handle,  MD_REPLACE,  pxy,  &s,  &d,  index); 
else  /*  Quellbild  in  Farbe  zeichnen  */ 
vro_cpyfm  (out_handle,  S_0NLY,  pxy,  &s,  &d); 

) /*  show_blt_ image  */ 

/»»»»*»**»*»  lHHHHHHt  *»*»»»»»*»»*»»»**»»»***»»**»»»***»»*«»»»»***»»*»» / 

LOCAL  VOID  read_bit_image  (filename) 

STRING  filename; 

[ 


WORD 

handle; 

WORD 

i,  screen_planes; 

WORD 

max_ lines; 

LONG 

planes ize,  1; 

IMG_HEADER 

»img_header; 

LONG 

img_len; 

UBYTE 

*img_buffer; 

UBYTE 

*raster_buf ; 

UBYTE 

»raster_ptr; 

UBYTE 

»plane_ptr  [MAX_PLANES] ; 

LONG 

rast_buflen; 

UBYTE 

»line_buf; 

LONG 

l_buflen; 

WORD 

fww; 

handle  = Fopen  (filename,  0); 

if  (handle 

>=  0) 

v.clrwk  (out_handle) ; 

img_len  = Fseek  (OL,  handle,  2); 

img.buffer  = (UBYTE  »)Malloc  (img.len); 

Fseek  (OL,  handle,  0); 

if  (lmg_buffer  ==  NULL) 
form_alert  (1,  alerts  [NOMEMORY]); 
else 

I 

img_len  = Fread  (handle,  img_len,  img_buffer); 
img_header  = (IMG_HEADER  ^^)lmg_buffer; 

#if  18086 

flip.word  ((UBYTE  »)&headlen); 

for  (i  = 0;  i < headlen;  i-H-)  flip_word  (&img_buffer  [1  * 2]); 
#endlf 
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vq_extnd  (out_handle,  TRUE,  work_out); 

screen_planes  = work_out  [4]; 

if  ( img_header->planes  ==  1)  screen_plaiies  = 1; 

fww  = (lmg_header->sl_width  + 15)  / 16; 

l_buflen  = ( img_header->sl_width  +7)  / 8; 
llne.buf  = (UBYTE  »)Malloc  (l.buflen); 

raax_lines  = img_header->sl_height; 

#if  MSDOS  1 FLEXOS 

raax_llnes  = 65536L  / (2L  * fww  * screen_planes) ; 
max_lines  = min  (max_lines,  img_header->sl_helght) ; 

#endif 

planeslze  = 2L  * fww  * raax_llnes; 
rast_buflen  = planeslze  * screen_planes; 
raster_buf  = (UBYTE  *)Malloc  (rast_buflen) ; 
raster.ptr  = raster.buf; 

if  (Ciine_buf  ==  NULL)  1 1 (raster.buf  ==  NULL)) 

( 

form_alert  (1,  alerts  [NOMEMORY]); 
return; 

] /*  if  */ 

for  (i  = 0;  i < screen_planes;  i++) 
plane_ptr  [i]  = raster.buf  + i » planeslze; 

for  (1=0;  1 < rast.buflen;  1++)  raster.buf  [1]  = 0; 

show.b it. image  (img.header,  Img.buffer,  raster.buf,  raster.ptr, 
llne.buf,  l.buflen,  plane.ptr,  raax.llnes, 
screen.planes,  fww); 

Mfree  (raster.buf); 

Mfree  (llne.buf); 

Mfree  (img.buffer); 

] /*  else  */ 

Fclose  (handle) ; 

] /»  if  V 

else 

form.alert  (1,  alerts  [NOFILE]); 

] /*  read.b it. image  ♦/ 
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LOCAL  VOID  show_page  () 

( 

WORD  pxy  [4]; 

pxy  [0]  = out_device.x; 

pxy  [1]  = out_device.y; 

pxy  [2]  = out_ device. X + out_device.w  - 1; 

pxy  [3]  = out_ device. y + out_device.h  - 1; 

vswr_mode  (out.handle,  MD.REPLACE); 
vsf_interlor  (out_handle,  FIS_SOLID); 
vsf_color  (out_handle,  BLACK); 

vr_recfl  (out_handle,  pxy);  /*  Blldschirm  schwarz  fallen  */ 

pxy  [0]  = dst.x; 

pxy  [1]  = dst.y; 

pxy  [2]  = dst.x  + dst.w  - 1; 

pxy  [3]  = dst.y  + dst.h  - 1; 

vswr_raode  (out_handle,  MD_REPLACE); 
vsf_lnterlor  (out_handle,  FIS_S0LID); 
vsf_color  (vdi_handle,  WHITE); 

vr_recfl  (out_handle,  pxy);  /*  AusgabegrdBe  welD  fallen  */ 
vs_clip  (out_handle,  TRUE,  pxy); 
j /*  show_page  */ 

/»»»»»»»»*»*»»*»»»*»»***»**»**»*»**»»**«*»»»«**»*»*»»**»»;(»**»»*»*#»/ 

LOCAL  VOID  do.command  (device,  flip_x,  fllp_y) 

WORD  device; 

BOOLEAN  flip_x,  flip_y; 


( 

WORD  1,  esc; 

STRING  filename,  img_name; 


esc  = 0; 

if  (contrl  [0]  ==  V_ESC)  /*  Bit-Images  nlcht  direkt  auf  Bildsch.  */ 

{ 

esc  = contrl  [5]; 

if  ((esc  ==  V_BIT_IMAGE)  &&  (device  ==  SCREEN)) 

[ 

esc  = -1; 
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strcpy  (filename,  fs_iinpath); 

1 = strlen  (filename); 

while  (filename  [1]  !=  PATHSEP)  1—; 

filename  [1+1]  = EOS; 

for  (1=0;  1 < contrl  [3]  - 5;  1++) 
lmg_name  [1]  = Intin  [5+1]; 
lmg_name  [1]  = EOS; 
strcat  (filename,  lmg_name); 

if  (flle_exlst  (filename)) 
read_b it_ image  ( filename ) ; 
else 

form_alert  (1,  alerts  [NOFILE]); 

) /*  if  */ 

) /*  if  */ 

switch  (contrl  [0]) 

{ 

case  V_ESC  : 

case  V_PLINE  : 
case  V_PMARKER  : 
case  V_GTEXT  : 
case  V_FILLAREA  : 
case  V_GDP  : 

case  VR_RECFL  : 

case  VS_CLIP  : transform  (flip_x,  flip_y); 
break; 

case  VSL_WIDTH  : ptsln  [0]  = new_wldth  (ptsln  [0]); 
break; 

case  VST_HEIGHT  : 
case  VSM.HEIGHT  : 

case  V_T0PB0T  : ptsln  [1]  = new_height  (ptsln  [1]); 
break; 

case  VST_P0INT  : If  (device  ==  SCREEN)  /*  use  vst_helght  */ 

( 

vdl  ( ) ; /*  do  vst_polnt  */ 

contrl  [0]  = VST_HEIGHT; 
contrl  [1]  = 1; 
contrl  [3]  = 0; 

ptsln  [0]  =0; 

ptsln  [1]  = dst_factor  * ptsout  [1]; 
if  (ptsln  [1]  ==  0)  ptsln  [1]  = 1; 

) /*  if  */ 
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else 

intin  [0]  = dst_factor  * intin  [0] ; 
break; 

) /*  switch  */ 

if  (esc  >=  0)  vdi  () ; 

) /*  do_cominand  */ 

/»*»***»»*»**»*»»»»»»*»»»»»»»»***»»*»*»*»*»»»»*»»»****»»**»»»»***»»»/ 

LOCAL  VOID  show_meta  (device,  best.fit,  usr_break) 

WORD  device; 

BOOLEAN  best_fit; 

BOOLEAN  usr_break; 


WORD  command; 

WORD  minmax  [4] ; 

BOOLEAN  flip_x,  flip_y; 

BOOLEAN  ok; 

WORD  msgbuf  [8] ; 

WORD  i,  event; 

UWORD  kr; 

src_pixel.w  = dst_pixel.w; 

src_pixel.h  = dst_pixel.h; 

aspect_f actor. w = 1.0; 
aspect_f actor. h = 1.0; 
dst_f actor  = 1.0; 
origo.x  = 0; 

origo.y  = 0; 

src.x  = 0; 
src.y  = 0; 
src.w  = 32768L; 
src.h  = 32768L; 

dst.x  = out_device.x; 
dst.y  = out_ device. y; 
dst.w  = out_devlce.w; 
dst.h  = out_device.h; 


minmax  [0]  = dst.x; 

minmax  [1]  = dst.y; 

minmax  [2]  = dst.w  - 1; 

minmax  [3]  = dst.h  - 1; 
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vs_clip  (out_handle,  TRUE,  minmax); 
get_header_info  (best_flt); 

flip_x  = FALSE; 

flip_y  = raeta_header->transforra  !=  RC; 

#lf  GEM  & GEM3 

if  (device  !=  SCREEN) 

[ 

if  (raeta_header->pwidth  < meta_header->pheight) 
v_orient  (out_handle,  OR_PORTRAIT) ; 
else 

v_orient  (out_handle,  OR_LANDSCAPE) ; 

] /*  else  */ 

#endif 

#if  DEBUG 

show.debug  (flip_x,  flip_y); 

#endif  /*  DEBUG  */ 

if  ((device  ==  SCREEN)  && 

(meta_header->bit_image  !=  l))  show_page  (); 

conunand  = 0; 
ok  = TRUE; 

while  (get_code  ()  &&  ok) 

[ 

command-H-; 

do_command  (device,  flip_x,  flip_y); 

if  (usr_break) 

( 

event  = evnt.multi  (MU.KEYBD  + MU.TIMER, 

1,  1,  1,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0, 

rasgbuf,  0,  0,  &i,  &i,  &i,  &i,  &kr,  &i); 

if  (event  & MU.KEYBD) 
if  ((kr  & OxFF)  ==  ESC) 
ok  = FALSE; 
else 

wait  0; 

) /*  if  */ 

) /»  while  »/ 

v.updwk  (out_handle) ; 

] /*  show_meta  */ 


4.2  Erlduterungen  zum  Programm  SHOWGEM 


279 


LOCAL  BOOLEAN  select_file  (name,  suffix,  filename) 
BYTE  »name,  ^suffix,  ^filename; 


WORD  1; 

BYTE  s [80]; 

if  (»suffix)  /*  Suffix  tadem  */ 

{ 

1 = strlen  (fs.iinpath) ; 
while  (fs_linpath  [i]  !=  PATHSEP)  i— ; 
fs_ilnpath  [i  + 1]  = EOS; 
strcat  (fs_iinpath,  suffix); 

] /»  if  */ 

name  [12]  = EOS; 

if  (»name)  strcpy  (fs_llnsel,  name);  /*  Default-Name  */ 
fsel.input  (fs_iinpath,  fs.iinsel,  &fs_iexbutton) ; 

strcpy  (s,  fs.iinpath);  /*  Path  aufbereiten  */ 

i = strlen  (s); 
while  (s  [1]  !=  PATHSEP)  i— ; 
s [1  + 1]  = EOS; 

if  (*fs_iinsel) 

{ 

strcpy  (filename,  s); 
strcat  (filename,  fs.iinsel); 

] /*  if  */ 
else 
[ 

filename  [0]  = EOS; 
fs.lexbutton  = 0; 
j /»  else  */ 

return  (fs.lexbutton  !=  0); 

) /*  select.file  */ 

GLOBAL  WORD  main  () 

( 

WORD  1; 

WORD  device; 

WORD  sel_ device; 


/*  Keinen  Datelnamen  gew&hlt  */ 
/*  Abbruch  */ 
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WORD  exit_obj ; 

BOOLEAN  best_flt,  ok; 

BOOLEAN  usr_break; 

BYTE  filename  [13]; 

STRING  act_path,  s; 

LONG  swidth,  sheight; 

gl_apid  = appl_lnit  (); 

phys_handle  = graf .handle  (&gl_wbox,  &gl_hbox, 

&gl_wattr,  &gl_hattr); 
vdi_handle  = open_work  (SCREEN) ; 

swidth  = out.device.w  * dst.pixel.w  / 1000;  /*  in  mm  */ 

sheight  = out_device.h  * dst.pixel.h  / 1000;  /*  in  mm  »/ 

if  (init.resource  ()) 

{ 

sprintf  (s,  "%31d",  swidth); 
set.ptext  (dialog,  SWIDTH,  s); 
sprintf  (s,  sheight); 

set.ptext  (dialog,  SHEIGHT,  s); 

get.path  (act.path,  0); 

strcpy  (fs.iinpath,  "A:");  /*  Standard-Zugriffspfad  */ 

sprintf  (fs.iinpath,  "A:)5s».GEM",  act.path); 

fs.iinpath  [0]  +=  Dgetdrv  ();  /*  Standard-Laufwerk  */ 

fs.iinsel  [0]  = EOS;  /*  Leerer  Dateiname  »/ 

strcpy  (meta_name,  ""); 
strcpy  (filename,  " ")  > 

while  (select.file  (filename,  "*.GEM",  meta.name)  &&  *meta_name) 

{ 

ok  = FALSE; 

if  (file.exist  (meta_name)) 

[ 

strcpy  ((BYTE  *)dialog  [FILENAME] .ob_spec,  fs.iinsel); 
exit.obj  = hndl_dial  (dialog,  0,  0,  0,  0,  0); 
if  (exit.obj  ==  DSTART)  ok  = TRUE; 

] /*  if  »/ 
else 

form_alert  (1,  alerts  [NOFILE]); 


graf.mouse  (M.0FF,  NULL); 
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if  (ok  &&  read_meta  (meta_name)) 

{ 

best.flt  = (dialog  [SBESTFIT] .ob_state  & SELECTED)  !=  0; 
usr_break  = (dialog  [DSTOP] .ob_state  & SELECTED)  !=  0; 

sel_device  = 1; 
for  (1=0;  i < 4;  1++) 
if  (dialog  [DSCREEN  + l].ob_state  & SELECTED) 
sel_ device  = i + 1; 

switch  (sel_device) 

{ 

case  1 : device  = SCREEN;  break; 

case  2 : device  = PLOTTER;  break; 

case  3 : device  = PRINTER;  break; 

case  4 : device  = CAMERA;  break; 

default  : device  = 0;  break; 

j /*  switch  */ 

if  (device  > 0) 

{ 

switch  (device) 

( 

case  SCREEN  : out_handle  = vdi_handle; 

get_dev_info  (out_handle) ; 

get_ptext  (dialog,  SWIDTH,  s); 
sscanf  (s,  &swidth); 

get_ptext  (dialog,  SHEIGHT,  s); 
sscanf  (s,  "!Kld",  &sheight); 

dst_pixel.w  = swidth  * 1000  / 
out_device.w; 

dst_pixel.h  = shelght  * 1000  / 
out_device.h; 

v.clrwk  (out_handle) ; /»  Blld.  Idschen  */ 
break; 

case  PLOTTER  : 
case  PRINTER  : 

case  CAMERA  : out_handle  = open_work  (device); 
break; 

] /*  switch  */ 
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if  (out_handle  ==  0) 

( 

graf_raouse  (M_0N,  NULL); 
forra_alert  (l,  alerts  [NODEVICE]); 
graf_mouse  (M_0FF,  NULL); 
j /*  If  »/ 
else 
( 


if  (gdos_ok  0) 

more_fonts  = vst_load_fonts  (out_handle,  0); 
if  (device  !=  SCREEN)  show.dial  (working); 

show_raeta  (device,  best_fit,  usr.break); 

if  (device  !=  SCREEN)  end_dial  (working); 
if  (gdos_ok  0)  vst_unload_fonts  (out_handle,  0); 

switch  (device) 

( 

case  SCREEN  : wait  ();  break; 

case  PLOTTER  : 

case  PRINTER  : 

case  CAMERA  : close.work  (device);  break; 

] /*  switch  */ 

) /»  if  */ 

) /*  if  */ 

Mfree  (meta_buf fer) ; 

] /*  if  »/ 

v.clrwk  (vdi_handle) ; 
graf_mouse  (M_0N,  NULL) ; 

) /*  while  */ 

rsrc_free  ( ) ; 

] /*  if  */ 

close_work  (SCREEN); 
appl_exit  0; 
return  (0); 

) /*  main  */ 


Beginnen  wir  am  Ende,  mil  dem  Hauptprogramm.  Dort  sehen  wir  schon  einige  GEM- 
typische  Aufruffolgen  sowie  das  Benutzen  von  Dialogboxen. 
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— main 

Zunachst  wird  die  Applikation  initialisiert,  und  wir  besorgen  uns  die  physikalische  Ken- 
nung  des  Bildschirms  (phys_handle).  Dann  wird  der  Bildschirm  virtuell  geoffnet,  da 
wir  ihn  ofters  benotigen.  Wir  bekommen  das  vdi_handle  zuriick. 

Jetzt  wird  die  Breite  und  Hohe  des  Bildschirmes  in  mm  berechnet.  Diese  Werte  werden 
sparer  als  Vorschlag  in  der  Dialogbox  erscheinen. 

Die  Funktion  init_resource  ladt  die  Resource-Datei  und  initialisiert  alle  Objekte.  Da- 
nach  werden  die  Breite  und  die  Hohe  in  die  Dialogbox  gesetzt.  Zunachst  wird  der  Wert 
von  swidth  in  die  Zeichenkette  s umgewandelt  (sprintf).  AnschlieBend  wird  uber  die 
Funktion  set_ptext  der  Text  s in  das  Feld  SWIDTH  (Konstante  aus  SHOWGEM. H,  er- 
zeugt  mit  dem  Resource  Construction  Set)  der  Dialogbox  dialog  gesetzt.  Die  Funktion 
set_ptext  holt  sich  aus  dem  Wert  ob_spec  die  Adresse  der  Struktur  vom  Typ  TEDIN- 
FO  und  setzt  den  Text  in  das  Feld  te_ptext.  Das  gleiche  gilt  fur  die  Bildschirmhohe. 

Der  aktuelle  Pfad  fiir  die  Dateiauswahlbox  wird  geholt  und  mit  dem  aktuellen  Laufwerk 
verknupft.  Die  while-Schleife  wird  so  lange  wiederholt,  bis  der  Benutzer  den 
ABBRUCH-Knopf  in  der  Dateiauswahlbox  wahlt  oder  einen  leeren  GEM-Namen  zu- 
riickgibt. 

Existiert  die  Datei  (file_exist),  so  wird  der  gewahlte  Dateiname  aus  fs_iinsel  in  die 
Dialogbox  gesetzt.  Der  Dialog-Handler  (hndl_dial)  wird  aufgerufen,  und  der  Knopf, 
den  der  Benutzer  angewahlt  hat,  wird  zuruckgeliefert  (exit_obj).  Wenn  der  Benutzer 
den  Knopf  START  gewahlt  hat,  wird  ok  auf  TRUE  gesetzt.  AnschlieBend  wird  die  Maus 
versteckt. 

Jetzt  wird  die  Metadatei  eingelesen,  und  verschiedene  Werte  werden  aus  der  Dialogbox 
besorgt.  Die  Variable  best_fit  enthalt  TRUE,  wenn  im  Status  des  Knopfes  SBESTFIT 
aus  dem  Objektbaum  dialog  das  Bit  SELECTED  gesetzt  war.  Entsprechendes  gilt  fiir  die 
Variable  usr_break. 

In  der  nachfolgenden  Schleife  wird  das  Ausgabegerat  bestimmt.  Wenn  das  Bit  SELEC- 
TED im  Status  eines  der  vier  Piktogramme  gesetzt  war,  wird  die  Variable  sel_device 
gesetzt.  Da  es  sich  um  Radio-Buttons  handelt,  wird  garantiert,  daB  immer  genau  ein  Aus- 
gabegerat gesetzt  ist. 

Aus  dem  Wert  von  sel_device  wird  die  Variable  device  auf  die  Kennung  fur  opnwk  ge- 
setzt (SCREEN  = 1,  PLOTTER  =11,  usw). 

War  die  Nummer  des  Ausgabegerats  groBer  als  0 (eigentlich  immer  der  Fall),  so  werden 
weitere  Aktionen  durchgefiihrt.  Je  nach  Ausgabegerat  werden  verschiedene  Initialisierun- 
gen  vorgenommen.  Beim  Bildschirm  werden  aus  der  Dialogbox  die  beiden  Werte  fur 
Bildschirmbreite  und  -hohe  ausgelesen  und  mit  ihnen  die  tatsachliche  PixelgroBe  berech- 
net. AnschlieBend  wird  der  Bildschirm  geloscht. 
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Bei  alien  anderen  Geraten  wird  eine  physikalische  Workstation  (open_work)  gedffnet, 
wobei  die  Kennung  out_handle  zuriickgeliefert  wird. 

1st  diese  Kennung  0,  so  konnte  das  Gerat  nicht  gedffnet  werden.  Die  Maus  wird  einge- 
schaltet  und  iiber  form  alert  eine  Fehlermeldung  ausgegeben. 

Ansonsten  wird  gepriift,  ob  das  GDOS  installiert  ist.  Die  Funktion  gdos_ok  liefert  unter 
MSDOS  und  FLEXOS  immer  den  Wert  TRUE  zuriick,  da  das  GDOS  dort  ein  fester  Be- 
standteil  des  GEM  ist. 

Bei  einem  ATARI  ST  wird  unter  TURBO  C die  Funktion  vq_gdos  aufgerufen,  Sie  lie- 
fert TRUE,  wenn  das  GDOS  installiert  ist  (siehe  Kap.  2.3,  VDI).  Bei  den  anderen  Compi- 
lem  ist  diese  Funktion  noch  nicht  verfiigbar.  Sie  wird  aber  als  Assemblerquelltext  der 
Diskette  beigefiigt.  Wenn  Sie  sie  benutzen  wollen,  so  linken  Sie  das  Objektmodul  bitte 
mit.  Ansonsten  liefern  Sie  den  Wert  TRUE  oder  FALSE  in  gdos_ok  zuriick,  je  nach- 
dem,  ob  Sie  es  installiert  haben  oder  nicht. 

Ist  das  GDOS  vorhanden,  so  werden  zusatzliche  Zeichensatze  geladen.  Wurde  die  Ausga- 
be  nicht  auf  den  Bildschirm  gesteuert,  so  wird  eine  Meldung  ausgegeben,  die  den  Ausga- 
bevorgang  signalisiert.  Die  Funktion  show_meta  sendet  die  Grafik  korrekt  skaliert  an 
das  Ausgabegerat,  je  nach  Einstellung  der  Variablen  best_fit. 

AnschlieBend  wird  die  Dialogbox  vom  Bildschirm  entfernt,  falls  die  Ausgabe  nicht  auf 
den  Bildschirm  ging.  SchlieBlich  werden  die  Zeichensatze  wieder  aus  dem  Speicher 
entfernt. 

Jetzt  folgen  die  AbschluBhandlungen.  War  das  Ausgabegerat  der  Bildschirm,  so  wird  auf 
einen  Tastendruck  oder  einen  Druck  auf  den  Mausknopf  gewartet.  Bei  alien  anderen  Aus- 
gabegeraten  wird  die  Arbeitsstation  wieder  geschlossen  (close_work). 

SchlieBlich  wird  der  meta_buffer  freigegeben,  der  in  der  Funktion  read_meta  reser- 
viert  wurde.  Jetzt  werden  der  Bildschirm  geldscht  sowie  die  Maus  wieder  eingeschaltet. 

Am  Ende  wird  die  geladene  Resource-Datei  freigegeben  (rsrc_free),  der  Bildschirm  als 
Arbeitsstation  geschlossen  (close_work),  die  Applikation  beendet  und  der  Wert  0 an  das 
Programm,  welches  SHOWGEM  aufgerufen  hatte,  zuriickgegeben. 

Nun  schauen  wir  uns  noch  einige  wichtige  Funktionen  an,  die  mit  Metadateien  und  Bit- 
Image-Dateien  zu  tun  haben. 


— read_meta 

Die  Metadatei  wird  gedffnet  und  deren  Lange  berechnet.  Wir  reservieren  dynamisch 
Speicher,  um  die  Datei  komplett  einzulesen  (Malloc,  Fread).  Lauft  das  Programm  auf 
leinem  MC68000-Rechner  (ATARI  ST,  ATARI  TT),  so  wird  die  gesamte  Metadatei  wort- 


4.2  Erlduterungen  zum  Programm  SHOWGEM 


285 


weise  gedreht,  da  sie  irnmer  im  INTEL-Format  vorliegt.  Die  Variable  meta_header 
wird  auf  den  Anfang  des  Puffers  gesetzt  und  der  meta_index  auf  den  Beginn  der  VDI- 
Kommandos  (aus  headlen  ersichtlich).  Am  Ende  wird  die  Datei  geschlossen. 


— show_meta 

Zunachst  werden  Default-Werte  eingestellt  und  das  Clipping  auf  die  GroBe  des  Ausgabe- 
gerates  gestellt  (dst).  AnschlieBend  werden  die  Angaben  aus  dem  Kopf  der  Metadatei  aus- 
gewertet  (get_header_info).  Lesen  Sie  bitte  in  dieser  Funktion  weiter.  Dort  wird  das 
Koordinatensystem  benutzt,  um  die  GroBe  der  Grafik  zu  bestimmen.  Danach  wird  die 
GroBe  eines  Pixel  mit  Hilfe  der  Werte  pwidth  und  pheight  aus  der  Metadatei  berechnet. 
Mit  Hilfe  dieser  Werte  kann  der  Aspect-Faktor  berechnet  werden.  Er  sagt  aus,  um  wieviel 
ein  Bild  gedehnt  Oder  gestaucht  werden  muB.  Liegt  die  Metadatei  im  NDC-System  vor, 
so  miissen  Y-Koordinaten  gespiegelt  werden.  SchlieBlich  wird  die  AusgabegroBe  des  Bil- 
des  berechnet  und  es  wird  zentriert.  Nun  aber  zuruck  zu  show_meta.  Nach  dem  Holen 
der  Header-Informationen  wird  das  Bild  ab  GEM/3  im  Quer-  oder  Hochformat  aus- 
gegeben. 

Wer  Debug-Informationen  haben  mochte,  muB  den  Wert  DEBUG  am  Anfang  des  Pro- 
grammes auf  1 setzen.  Es  lohnt  sich  fiir  die  Untersuchung  von  Metadateien  in  jedem  Fall. 
Soil  die  Metadatei  auf  den  Bildschirm  ausgegeben  werden,  so  wird  die  Seite  auf  dem  Bild- 
schirm  weiB  dargestellt  (show_page). 

Jetzt  werden  die  einzelnen  VDI-Codes  aus  dem  Metadatei-Puffer  geholt  (get_code)  und 
die  Grafik-Befehle  auf  dem  Bildschirm  dargestellt  (do_command).  Falls  man  mit  einer 
Taste  anhalten  mochte,  wird  die  Tastatur  abgefragt.  1st  kein  Zeichen  verfiigbar 
(MU_TIMER),  so  wird  die  Event-Schleife  verlassen.  Ansonsten  wird  auf  die  Taste 
ESC  gepriift.  1st  die  Grafik  komplett  ausgegeben,  so  wird  das  Ausgabegerat  aktualisiert 
(v_updwk),  was  z.B.  fiir  Drucker  wichtig  ist. 


— do_command 

In  do_command  wird  zunachst  getestet,  ob  es  sich  um  einen  VDI-ESC-Befehl  handelt. 
War  es  der  Befehl  zur  Ausgabe  einer  Bit-Image-Datei  und  war  das  Ausgabegerat  der  Bild- 
schirm, so  wird  die  Pixelgrafik  iiber  die  Funktion  read_bit_image  ausgegeben. 

Danach  wird  gemaB  dem  VDI-Befehl  (contrl  [0])  zu  verschiedenen  Aktionen  verzweigt. 
Bei  den  meisten  Befehlen  werden  jetzt  die  Punkt-  und  Radius-  sowie  Langenkoordinaten 
in  die  neue  AusgabegroBe  transformiert.  Zeilenbreiten  (VSL_ WIDTH)  sowie  Text- 
hohen  (VST_HEIGHT)  werden  angepaBt.  Bei  PunktgrdBen  wird  auf  dem  Bildschirm 
besonders  verfahren.  Dort  wird  nicht  vst_point,  sondem  vst_height  benutzt.  Damit 
werden  Zeichen  auf  dem  Bildschirm  beliebig  skaliert.  Ansonsten  wird  die  PunktgroBe 
iiber  den  Wert  dst_factor  angepaBt. 
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— init_resource 

Interessant  ist  noch  die  Funktion  init_resource.  Nach  dem  erfolgreichen  Laden  der 
Resource-Datei  wird  die  Bildschirmauflosung  getestet.  Ist  die  Hohe  eines  Zeichens  aus 
dem  Standardzeichensatz  grdfSer  als  8,  so  handelt  es  sich  um  einen  hochauflosenden  Bild- 
schirm.  Dann  wird  die  Dialogbox  DIALOGH,  sonst  die  Dialogbox  DIALOGL  benutzt. 
Sie  enthalten  die  gleichen  Objekte  mit  Ausnahme  der  Piktogramme.  Sie  sind  kleiner  ge- 
staltet,  da  die  Dialogbox  sonst  nicht  mehr  auf  den  Bildschirm  passen  wiirde.  Schauen  Sie 
sich  die  Resource-Datei  auf  Diskette  doch  einmal  genauer  an. 

Nachdem  die  Fehlermeldungen  geholt  wurden  (R_STRING),  werden  alle  Dialogboxen 
angepaBt  (fix_objs).  Besonders  bei  benutzerdefinierten  Objekten  miissen  Aktionen 
durchgefiihrt  werden.  Zum  SchluB  wird  das  Piktogramm  des  Bildschirmes  sowie  der 
Radio-Knopf  „Einpassen“  vorselektiert.  Ein  Wert  muB  dort  ja  vorbelegt  sein. 

- fix_objs 

Alle  notigen  Anpassungen  fiir  Piktogramme  sowie  benutzerdefinierte  Objekte  werden 
durchgefiihrt.  Piktogramme  (Icons  und  Bit-Images)  miissen  vom  Standardformat  ins  gera- 
tespezifische  Format  gewandelt  werden.  In  der  Anweisung  switch  (xtype)  werden  die  be- 
nutzerdefinierten Objekte  angepaBt.  Die  Breite  und  Hohe  dieser  Objekte  wird  etwas  ver- 
kleinert.  Damit  ist  es  mdglich,  Boxen  in  aufeinanderfolgenden  Zeilen  zu  plazieren,  ohne 
daB  sie  sich  direkt  beriihren  (siehe  SCRAP,  Menii  Optionen,  Meniipunkt  Einstellungen 
Oder  Abbildung  der  Druckerauswahlbox).  Dadurch  bekommt  man  wesentlich  mehr  Infor- 
mationen  auf  dem  Bildschirm  unter. 

Die  beiden  Zuweisungen 

ob->ob_type  = G_USERDEF;  und 

ob->ob_spec  = (LONG)&check_blk;  bzw.  = (LONG)&radlo_blk; 

diirfen  beim  Laser  C-Compiler  nicht  gemacht  werden.  Er  kann  leider  noch  keine  benut- 
zerdefinierten Objekte  verwalten.  Vielleicht  klappt  es  in  einer  spateren  Version.  Alle  an- 
deren  Operationen  miissen  aber  gemacht  werden,  damit  wenigstens  die  GroBe  der  Box 
angepaBt  wird. 


- draw_checkbox 

- draw_rbutton 

Die  beiden  Funktionen  draw^checkbox  sowie  draw_rbutton  werden  vom  AES  ange- 
sprungen,  wenn  die  Checkbox  bzw.  ein  runder  Radio-Knopf  gezeichnet  Oder  verandert 
werden  muB  (siehe  auch  Kap.  2.5). 

Damit  sind  die  Erlauterungen  zu  SHOWGEM  abgeschlossen.  Die  Teile  fur  das  Zeichnen 
von  Metadateien  und  Bit-Image-Dateien  sind  auch  im  Programm  SCRAP  integriert.  Noch 
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ein  letzter  Tip:  Schauen  Sie  sich  zuerst  die  Resource-Datei  SHOWGEM. RSC  und  SHOW- 
GEM. H an.  Dann  sehen  Sie,  welche  Objekte  einen  Namen  bekommen  haben  und  so  fiir 
das  Programm  wichtig  sind. 

Lassen  Sie  sich  auch  an  den  Programmstellen,  wo  Sie  nicht  alles  verstehen,  die  beteiligten 
Variablen  und  Werte  ausgeben  (DEBUG  = 1)  und  benutzen  Sie  dann  die  Funktion  wait, 
um  sich  die  Ergebnisse  anzusehen  (siehe  auch  show_debug). 
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Betrachtet  man  verschiedene  GEM-Programme  gleicher  Kategorie  (z.B.  Textverarbei- 
tung,  Datenbanken)  auf  einem  Atari  ST,  so  fallt  auf,  daB  einige  einfach,  andere  wieder 
schwieriger  Oder  sehr  schwierig  zu  bedienen  sind.  Trotz  gleicher  Aufgabenstellung 
scheint  es  von  mehreren  Faktoren  abzuhangen,  daB  Programme  als  „leicht“  oder 
„schwer“  erlernbar  oder  bedienbar  gelten.  GEM-Applikation  ist  offensichtlich  nicht 
gleich  GEM-Applikation,  obwohl  es  in  der  Werbung  immer  wieder  heiBt  „...ist  eine 
GEM-Applikation  und  damit  leicht  zu  bedienen." 


Betrachtet  man  andere  Rechner,  wie  den  Macintosh,  so  sieht  man  eine  Fulle  von  Pro- 
grammen,  die  einem  hohen  Qualitatsstandard  entsprechen.  Daten  von  einem  Programm 
konnen  leicht  in  ein  anderes  Programm  iibernommen  werden,  und  die  meisten  Program- 
me sind  leicht,  zumindest  aber  ahnlich  zu  bedienen.  Das  liegt  zum  einen  daran,  daB  beim 
Macintosh  die  grafische  Benutzeroberflache  nicht  auf  dem  Betriebssystem  aufsetzt  wie 
z.B.  beim  Atari  ST  (GEM  auf  TOS)  oder  dem  IBM  PC  (GEM  auf  DOS).  Zum  anderen 
ist  zu  sagen,  daB  sich  Programmierer  an  gewisse  Richtlinien  halten,  die  von  der  Bibel 
der  Macintosh-Programmierung  „Inside  Macintosh"  stammen. 

Beim  Atari  beispielsweise  gibt  es  eine  Fiille  von  verschiedenen  Grafikformaten.  Jeder 
kocht  — leger  ausgedriickt  — sein  eigenens  Siippchen  (Doodle,  Degas,  Neochrome, 
STAD,  Signum  etc.).  Um  nun  Grafik  von  einem  Programm  in  ein  anderes  zu  iiberneh- 
men,  braucht  man  Konvertierungsprogramme  oder  Snap- Accessories.  Dabei  gibt  es  ahn- 
lich wie  beim  Mac  zwei  von  Digital  Research  eingefuhrte  Standards:  die  Metadateien  und 
die  Bit-Image-Dateien.  Erstere  werden  unter  anderem  von  GEM-Draw,  letztere  von 
GEM-Paint  erzeugt.  Der  Aufbau  der  beiden  Dateien  wurde  in  Kapitel  2 oder  anderen 
Biichern  wie  z.B.  „Software-Entwicklung  auf  dem  Atari  ST“  genauestens  erklart. 

Wahrend  beim  bekannten  Textverarbeitungsprogramm  „ 1st  Word  Plus"  von  GST  bei  den 
ersten  Versionen  ein  eigenes  Format  zur  Abspeicherung  von  Bildem  benutzt  wurde,  wird 
bei  den  neueren  Versionen  das  Bit-Image-Datei-Format  unterstutzt.  Damit  konnen  also 
Bilder  aus  GEM-Paint  direkt  in  Word  Plus  iibernommen  werden.  Dies  ist  insbesondere 
deshalb  wichtig,  weil  Word  Plus  kein  Grafikeditor  ist. 
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Fiir  das  Design  eines  Programms,  also  Meniis,  Dialogboxen,  Bedienung  etc.  gibt  es  bis 
jetzt  keine  schriftlich  festgelegten  Standards  auf  dem  ST.  Wiirden  die  Automobilherstel- 
ler  sich  sowenig  an  Regeln  halten  wie  Software-Entwickler  auf  dem  ST,  so  kamen  wohl 
Autos  heraus,  bei  denen  sich  beispielsweise  das  Gaspedal  links,  das  Kupplungspedal  in 
der  Mine  und  das  Bremspedal  rechts  befinden.  Ein  solches  Auto  wurde  niemand  kaufen, 
wenn  bereits  alle  anderen  Autos  die  Pedale  in  der  uns  bekannten  Reihenfolge  anbieten 
wiirden. 


Das  Fehlen  von  Regeln  und  Standards  in  der  Anfangsentwicklung  bei  Erscheinen  des  Ata- 
ri ST  fiihrte  wohl  dazu,  daC  jeder  nach  eigenem  Gutdiinken  programmierte  und  seine  ei- 
genen  Regeln  fur  die  Besten  hielt.  Dennoch  gibt  es  einige  allgemeingiiltige  Regeln,  die 
man  beachten  sollte,  damit  GEM-Applikationen  komfortabel  in  der  Bedienung  werden. 
Ein  Teil  dieser  Regeln  stammen  aus  der  Arbeit  von  Card,  Moran  und  Newell  „The  Psy- 
chology of  Human-Computer  Interaction**.  Es  handelt  sich  bei  den  Autoren  um  Mitarbei- 
ter  von  PARC  (Palo  Alto  Research  Center)  von  Xerox.  Der  Xerox  Star  war  Anfang  der 
achtziger  Jahre  der  erste  kommerzielle  Rechner  mit  einer  grafischen  Benutzeroberflache 
und  einer  Mans  als  Eingabegerat.  Card  und  Moran  arbeiteten  am  AlP-Projekt  (Applied 
Information-Processing  Psychology),  also  am  Projekt  fiir  angewandte  informationsverar- 
beitende  Psychologic.  Bevor  nun  Regeln  fur  das  Design  von  GEM-Programmen  angege- 
ben  werden  sollen,  wird  die  Theorie  das  Wort  haben.  Wir  werden  sehen,  auf  welchen 
wissenschaftlichen  Grundlagen  die  Regeln  basieren,  die  spater  angefiihrt  werden. 


5.1  Theorie 


5.1.1  Die  Mensch-Maschine-Schnittstelle 


Trotz  der  Entwicklung  der  Schnittstellen  von  Lochstreifen  iiber  Lochkarten,  alphanume- 
rischen  Terminals  und  den  heutigen  Grafik-Terminals  mit  Bedienung  iiber  Maus  und  Fen- 
ster  ist  es  auffallend  zu  beobachten,  daB  viele  unnotige  Fehler  in  der  Bedienung  auftreten. 
Der  Grund  dafiir  ist  zum  einen  darin  zu  suchen,  daB  die  Interaktion  mit  dem  Rechner 
sehr  vielfaltig  sein  kann.  Maschinen,  die  friiher  von  Menschen  bedient  wurden,  hatten 
meist  eine  begrenzte  Anzahl  von  Aufgaben  zu  erledigen,  so  daB  der  Bedeutungsbereich 
von  Hebeln,  Knopfen  und  Radern  sehr  eng  war.  Wahrend  Maschinen  fruher  lediglich  be- 
dient wurden,  treten  die  Menschen  heute  in  echte  Kommunikation  mit  der  Maschine,  d.h. 
mit  dem  Rechner. 


Zum  anderen  fiihrte  die  radikale  Zunahme  der  Fahigkeiten  eines  Rechners  sowie  das  ver- 
besserte  Preis/Leistungsverhaltnis  dazu,  daB  mehr  Rechner  fur  mehr  Aufgaben  eingesetzt 
werden  konnten.  Die  Folge  war  eine  groBe  Anzahl  neuer  Stile  in  der  Interaktion  zwischen 
Mensch  und  Rechner.  Damit  verbunden  waren  komplett  neu  aufgebaute  Schnittstellen, 
an  die  sich  der  Mensch  jeweils  gewohnen  muBte. 
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5.1.2  Das  Modell  „Mensch-als-Prozessor“ 

Um  die  Interaktion  einer  Person  mil  dem  Rechner  zu  analysieren,  wird  der  Mensch  selbst 
als  Prozessor  betrachtet,  welcher  Informationen  verarbeiten  kann.  (siehe  Abb.  5.1). 


Quelle:  nach  Cavet, 
Movan  u.  Newell 
The  Psychology  of 
Human-Computer  Interac- 
tiar,  S.  26 


Abbildung  5.1:  Speicher  und  Prozessoren  des  „Mensch-Prozessor-Modells“ 


Beim  Betrachten  des  Modells  erkennen  wir:  Es  kann  durch  einen  Satz  von  Speicher  und 
Prozessoren  sowie  einer  Menge  von  Prinzipien  beschrieben  werden  und  wird  in  drei  in- 
teragierende  Untersysteme  zerteilt; 

a)  das  Wahrnehmungssystem  (Augen,  Ohren) 

b)  das  motorische  System  (Arme,  Hande) 

c)  das  Erkennungssystem  (Gedachtnis,  Gehirn) 

Jedes  dieser  Systeme  hat  seine  eigenen  Speicher  und  Prozessoren.  Das  Wahrnehmungs- 
system besteht  aus  Sensoren  und  angeschlossenen  Speicherpuffern  wie  dem  Abbildungs- 
speicher  fiir  das  Sehen  und  Horen.  Es  speichert  die  Daten  des  Sinnessystems,  wahrend 
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sie  symbolisch  decodiert  werden.  Das  Erkennungssystem  erhalt  symbolisch  codierte  In- 
formationen  aus  dem  Speicher  des  Kurzzeitgedachtnisses  und  benutzt  Informationen  aus 
dem  Langzeitgedachtnis,  urn  zu  entscheiden,  wie  auf  ein  Ereignis  reagiert  werden  soil. 
Die  Reaktion  wird  dann  vom  motorischen  System  ausgefiihrt. 

Es  wird  angenommen,  daJl  jedes  Untersystem  seinen  eigenen  Prozessor  und  seinen  eige- 
nen  Speicher  besitzt,  wobei  die  Prozessoren  seriell  oder  quasiparallel,  d.h.  in  der  Art  von 
Pipeline-Prozessoren  arbeiten  konnen. 

Die  Speicher  und  Prozessoren  werden  durch  gewisse  Parameter  beschrieben.  Die  Para- 
meter des  Speichers  sind; 

— die  Speicherkapazitat  in  Einzelpunkten 

— die  Verfallszeit  eines  Einzelpunktes 

— die  Art  der  Verschliisselung  (physisch,  akustisch,  visuell,  semantisch) 

Die  Speicherkapazitat  gibt  an,  wieviele  Einzelpunkte  der  Prozessor  sich  merken  kann. 
So  ist  der  Speicher  des  Kurzzeitgedachtnisses  kleiner  als  der  des  Langzeitgedachtnisses. 

Die  Verfallszeit  gibt  an,  wann  die  Wahrscheinlichkeit,  eine  bestimmte  Information  aus 
dem  Gedachtnis  zuriickholen  zu  konnen,  weniger  als  50%  betragt  (Halbwertszeit). 

- Die  Art  der  Verschlusselung  gibt  an,  wie  die  Information  letztendlich  im  Speicher 
vorliegt. 

Der  wichtigste  Parameter  eines  Prozessors  ist  die  Zykluszeit. 

Sie  gibt  an,  wie  schnell  Informationen  aufgenommen  werden  oder  Bewegungen  durchge- 
fiihrt  werden  konnen. 

a)  Das  Wahrnehmungssystem 

Das  Wahrnehmungssystem  fiihrt  Eindriicke  aus  der  realen  Welt,  die  vom  Sensorsystem 
des  Korpers  aufgenommen  werden,  in  interne  Reprasentationen  des  Gehirns  iiber.  Ein 
gutes  Beispiel  ist  das  visuelle  System.  Die  Retina  des  Auges  reagiert  auf  Licht  und 
„merkt“  sich  dessen  Intensitat,  Wellenlange  und  raumliche  Verteilung.  Obwohl  das  Auge 
eine  Szenerie  iiber  einen  breiten  Winkel  aufnimmt  (fast  180  Grad),  werden  Details  nur 
uber  einen  vergleichsweise  engen  Winkel  von  ungefahr  2 Grad  aufgenommen.  Dieser  Be- 
reich  wird  auch  Fovea  genannt.  Der  Rest  der  Retina  dient  mehr  der  Orientierung.  Das 
Auge  ist  beim  Betrachten  eines  Objekts  in  standiger  Bewegung.  Diese  ruckartigen  Bewe- 
gungen, auch  Sakkaden  genannt,  nehmen  jeweils  eine  Zeit  von  30  ms  in  Anspruch,  bevor 
die  Augen  auf  den  nachsten  Punkt  gesetzt  werden.  Sie  verweilen  dann  dort  fiir  eine  Dauer 
von  70  - 700  ms,  was  eine  durchschnittliche  Augenbewegungszeit  von  230  ms  ergibt. 

Kurz  nach  dem  Eintreffen  des  visuellen  Reizes  erscheint  eine  Representation  dieses  Rei- 
zes  im  „Visuellen  Abbildspeicher"  (VIS  = Visual  Image  Store).  Ahnliches  gilt  fur  das 
Gehor  (AIS  = Acoustic  Image  Store).  Die  Information  in  diesen  Speichern  wird  physisch 
als  nicht-symbolisches  Analogon  zum  externen  Reiz  gespeichert. 
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Zum  Beispiel  wird  die  Ziffer  2 nicht  als  solche  gespeichert,  sondem  deren  Reprasentation 
beinhaltet  Dinge  wie  Kriimmung  und  Lange.  Experimente  belegen  die  Tatsache  des  phy- 
sischen  Speicherns.  So  kann  eine  Testperson,  welche  eine  farbige  Liste  von  Zahlen  vorge- 
legt  bekommt,  sehr  schnell  beispielsweise  die  griinen  Zahlen  herauspicken,  wahrend  das 
Erkennen  von  geraden  oder  ungeraden  Zahlen  eine  bestimmte  Zeit  erfordert.  Im  letzten 
Fall  muB  das  Kurzzeitgedachtnis  des  Erkennungsprozessors  zu  Hilfe  genommen  werden. 
Fiir  Buchstaben  gilt  eine  Erkennungsrate  von  etwa  10  ms/Buchstabe. 

Der  visuelle  Abbildspeicher  hat  eine  Halbwertszeit  von  200  ms,  der  akustische  Abbild- 
speicher  von  1500  ms.  Dies  bedeutet,  daB  nach  der  angegebenen  Zeit  die  entsprechende 
Information  nur  noch  schwer  aus  dem  Speicher  zuriickzuholen  ist. 

Die  Kapazitat  des  visuellen  Abbildspeichers  betragt  7-17  Buchstaben,  die  des  akusti- 
schen  Speichers  5 Buchstaben.  Vor  dem  Verschwinden  der  Information  muB  diese  ins 
Kurzzeitgedachtnis  iibertragen  worden  sein  (s.u.). 

Die  Zykluszeit  des  Wahrnehmungsprozessors  liegt  bei  etwa  100  ms,  was  bedeutet,  daB 
Blinkraten  auf  dem  Bildschirm  eine  gewisse  Frequenz  (10/s)  nicht  uberschreiten  sollten. 
Sonst  werden  sie  nicht  mehr  unbedingt  als  diskrete  Ereignisse  wahrgenommen. 

Dies  gilt  allerdings  nicht,  wenn  der  Reiz  erhoht  wird,  was  am  Prinzip  der  variablen 
Wahmehmungsprozessor-Rate  deutlich  wird:  Die  Zykluszeit  des  Wahmehmungsprozes- 
sors  variiert  reziprok  zur  Intensitat  des  Reizes. 

b)  Das  motorische  System 

Fiir  Rechnerbenutzer  sind  die  besonders  zu  untersuchenden  Systeme  das  Arm-Hand- 
System  und  das  Kopf-Auge-System.  Bewegungen  laufen  nicht  kontinuierlich  ab,  sondern 
bestehen  aus  einer  Reihe  von  Mikrobewegungen.  Jede  dieser  Bewegungen  benotigt  etwa 
70  ms.  Dies  kann  als  Zykluszeit  des  motorischen  Prozessors  angesehen  werden. 

Analysieren  wir  die  Handbewegung  eines  Benutzers,  welcher  z.B.  mit  der  Maus  einen 
Pfeil  auf  dem  Bildschirm  in  ein  bestimmtes  Gebiet  bewegen  muB  (siehe  Abb.  5.2). 


s 


START 


TARGET 


D 

Abbildung  5.2:  Analyse  der  Handbewegung  eines  Benutzers 
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Die  Entfernung  zum  Zielpunkt  sei  D cm,  wogegen  das  Zielrechteck  S cm  breit  sei.  Wah- 
rend  die  Hand  nun  auf  das  Zielquadrat  zusteuert,  fiihrt  sie  eine  Reihe  von  Mikrobewegun- 
gen  aus.  Nach  jeder  Bewegung  werden  vom  Erkennungssystem  die  Hand  beobachtet  und 
eventuell  Korrekturen  herbeigefiihrt.  Startpunkt  sei  Xq.  Nach  jedem  neuen  Schritt,  bei 
dem  die  Hand  nun  naher  an  das  Ziel  kommt,  wird  der  Korrekturfaktor  kleiner.  Mit  Hilfe 
der  Zykiuszeiten  der  zugrundeliegenden  Prozessoren  kann  man  beweisen,  dafi  die  bend- 
tigte  Zeit  einzig  und  allein  von  der  relativen  Genauigkeit  abhangt,  d.h.  vom  Verhaltnis 
zwischen  Zieldistanz  (D)  und  ZielgroBe  (S).  Die  Folgerungen  werden  weiter  unten 
gezogen. 


c)  Das  Erkennungssystem 

Im  einfachsten  Fall  dient  das  Erkennungssystem  (kognitives  System)  dazu,  Eingaben  vom 
Wahrnehmungssystem  in  die  richtigen  Ausgaben  an  das  Motorsystem  umzusetzen.  Die 
meisten  von  Menschen  zu  bewaltigenden  Aufgaben  sind  jedoch  sehr  komplex,  so  dal)  die 
Speicher  des  kognitiven  Systems  komplizierter  sind  als  die  der  anderen  Systeme. 

Zwei  wichtige  Speicherbereiche  finden  sich  im  kognitiven  System:  das  Kurzzeitgedacht- 
nis  (WM  = Working  Memory),  welches  Informationen  enthalt,  die  in  der  aktuellen  Situa- 
tion gebraucht  werden,  und  das  Langzeitgedachtnis  (LTM  = Long  Term  Memory),  wel- 
ches Wissen  speichert,  das  auch  spiiter  noch  benutzt  werden  kann. 

Das  Kurzzeitgedachtnis 

Es  enthalt  Zwischenprodukte  von  Gedanken  und  die  Reprasentationen,  die  vom  Wahr- 
nehmungssystem produziert  werden.  Es  bildet  die  Register  des  kognitiven  Prozessors. 
Dabei  handelt  es  sich  im  Prinzip  um  eine  Untermenge  der  Elemente  des  Langzeitgedacht- 
nisses,  welche  gerade  aktiviert  ist.  Die  Codierung  im  Kurzzeitgedachtnis  geschieht  mit- 
tels  akustischer  oder  visueller  symbolischer  Codes.  Das  Kurzzeitgedachtnis  wird  nicht 
von  physischen  Parametern  wie  etwa  der  Intensitat  eines  Reizes  beeinfluBt. 

Im  Kurzzeitgedachtnis  bilden  sich  Symbole.  Die  Ersetzung  der  Symbole  hangt  nun  vom 
Inhalt  des  Langzeitgedachtnisses  ab  und  damit  von  der  Person  und  der  zu  Idsenden  Aufga- 
be.  So  kann  die  Buchstabenfolge 

BMIACRFSAB 

von  nur  wenigen  Menschen  nach  kurzem  Anblick  wiederholt  werden  (versuchen  Sie  es 
einmal),  wahrend  dieselbe  Liste  mit  etwas  geanderter  Reihenfolge 

IBMRCABASF 

leichter  behalten  werden  kann,  wenn  sie  etwa  beim  Lesen  oder  Buchstabieren  in 


IBM  RCA  BASF 
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aufgeteilt  wird.  Statt  neun  Symbole  wie  oben  hat  man  sich  nur  noch  drei  Symbole  zu  mer- 
ken  (eine  Computerfirma,  einen  Medienkonzern  und  einen  Chemie-Konzern).  Dies  gilt 
natiirlich  nur,  wenn  die  drei  Symbole  eine  Bedeutung  fur  den  jeweiligen  Menschen  haben. 
Daraus  kann  man  folgem,  daB  das  Kurzzeitgedachtnis  erheblich  entlastet  wird,  wenn  in 
der  Kommunikation  zwischen  Mensch  und  Rechner  Symbole  benutzt  werden,  die  mog- 
lichst  vielen  Menschen  bekannt  sind. 

Das  Kurzzeitgedachtnis  kann  nur  eine  begrenzte  Zahl  von  Symbolen  aufnehmen.  Wenn 
neue  Symbole  hinzukommen,  interferieren  sie  mit  den  bereits  vorhandenen  Symbolen  im 
Kurzzeitgedachtnis.  Die  Folge  ist  das  Vergessen  der  „alteren“  Symbole.  Die  Geschwin- 
digkeit,  mit  der  die  Symbole  vergessen  werden,  hangt  natiirlich  von  vielen  Faktoren  ab, 
wie  z.B.  der  Anzahl  von  anderen  Symbolen,  die  sich  der  Benutzer  merken  mufi. 

MuB  man  sich  nur  ein  Symbol  merken,  so  kann  man  sich  an  dieses  nach  etwa  73  Sekunden 
noch  aus  dem  Kurzzeitgedachtnis  erinnern.  Bei  drei  Symbolen  betragt  die  Halbwertszeit 
nur  noch  7 Sekunden.  Wird  die  reine  Kapazitat  des  Kurzzeitgedachtnisses  zugrunde- 
gelegt,  so  kommt  man  auf  eine  Anzahl  von  drei  Symbolen,  welche  man  sich  dort  merken 
kann.  Diese  reine  Kapazitat  wird  allerdings  erhoht,  da  das  Langzeitgedachtnis  mit  benutzt 
wird  (siehe  obiges  Beispiel  mit  den  Buchstaben).  Dann  ergibt  sich  eine  Kapazitat  von  7 
( + /—  2)  Symbolen.  Dies  wurde  bereits  1956  von  dem  Psychologen  George  A.  Miller 
herausgefunden.  Wir  werden  diese  Erkenntnis  spater  verwenden,  wenn  es  um  Mentis 
geht. 


Das  Langzeitgedachtnis 

Es  enthalt  die  Masse  des  verfugbaren  Wissens  eines  Benutzers  und  besteht  aus  einem 
Netzwerk  von  Symbolen,  die  in  einer  bestimmten  Beziehung  zueinander  stehen.  Auf  sie 
wird  uber  den  Inhalt  des  Kurzzeitgedachtnisses  zugegriffen.  Der  Inhalt  des  Langzeitge- 
dachtnisses  besteht  aus  der  deklarativen  und  prozeduralen  Wissensbasis.  Im  Prinzip  gibt 
es  kein  Vergessen  im  Langzeitgedachtnis,  so  daB  die  Halbwertszeit  als  unendlich  ange- 
sehen  werden  kann. 

Die  Riickholung  von  Information  hangt  jedoch  davon  ab,  ob  bestimmte  Assoziationen  ge- 
funden  werden  konnen.  Zwei  Griinde  kann  es  dafur  geben,  daB  keine  Information  mehr 
aus  dem  Langzeitgedachtnis  verfugbar  ist: 

1 . Effektive  Assoziationen  zur  Wiedergewinnung  konnen  nicht  gefunden  werden. 

2.  Ahnliche  Assoziationen  mit  mehreren  Symbolen  interferieren  bei  der  Riickholung  des 
Zielsymbols. 

Die  Verschlusselung  von  Information  im  Langzeitgedachtnis  liegt  in  semantischer  Form 
vor,  d.h.  die  neuen  Informationen  werden  verkniipft  mit  Informationen,  die  bereits  im 
Gedachtnis  stehen.  Ein  gutes  Beispiel  sind  (gute  oder  schlechte)  Vorurteile. 
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Das  Prinzip  der  spezifischen  Verschliisselung  besagt,  daB  sie  auf  alle  wahrgenommenen 
Dinge  angewandt  wird.  Sie  entscheiden,  wie  etwas  im  Langzeitgedachtnis  gespeichert 
wird  und  damit,  welche  Wiedergewinnungsstrategien  angewandt  werden,  um  die  gespei- 
cherte  Information  zu  erhalten.  Es  kommt  also  darauf  an,  mit  welchen  Assoziationen  eine 
bestimmte  Information  verbunden  wird,  um  sie  wieder  aus  dem  Langzeitgedachtnis  zu 
holen. 

Ein  Beispiel:  Ein  Benutzer  legt  mehrere  Dateien  auf  einem  Inhaltsverzeichnis  an.  Alle 
diese  Dateien  bezeichnen  Mbbelstucke.  Eine  davon  heifit  „Bank“,  wobei  er  z.B.  an  eine 
Eckbank  denkt.  Spater  untersucht  er  das  Inhaltsverzeichnis,  um  alle  seine  Dateien  anzuse- 
hen.  Im  Inhaltsverzeichnis  befmden  sich  nun  viele  Dateien,  die  er  nicht  angelegt  hat.  Als 
sein  Blick  auf  die  Datei  „Bank“  fallt,  assoziiert  er  damit  ein  Geldinstitut,  weil  er  noch 
einige  Dinge  auf  seiner  Bank  zu  erledigen  hat.  Die  Datei  „Bank“  wird  er  nicht  als  seine 
erkennen,  da  er  diese  mit  einem  Geldinstitut,  nicht  mit  einem  Mobelstiick  assoziiert. 

Durch  die  Uberlagerung  mit  anderen  Symbolen  im  Gedachtnis,  die  starker  durch  be- 
stimmte Assoziationen  aktiviert  wurden,  kann  es  vorkommen,  daB  Information,  obgleich 
physisch  vorhanden,  verlorengeht.  Man  nennt  dies  auch  das  Unterscheidungsprinzip.  Die 
Schwierigkeit,  etwas  aus  dem  Gedachtnis  wiederzugewinnen,  hangt  von  der  Anzahl  der 
„Kandidaten“  ab,  die  fur  die  entsprechende  Assoziation  in  Frage  kommen. 

An  einmalige  und  besondere  Situationen  kann  man  sich  also  leichter  erinnern  als  an  alltag- 
liche  Dinge,  die  immer  wieder  auftreten.  AuBerdem  ist  es  eher  moglich,  Informationen 
aus  dem  Gedachtnis  wiederzugewinnen,  je  mehr  Assoziationen  mit  dieser  Information 
verbunden  sind.  Wenn  ein  Benutzer  sich  spater  an  eine  Sache  erinnern  mochte,  so  ist  die 
beste  Strategie  diejenige,  diese  Sache  mit  etwas  in  Verbindung  zu  bringen,  was  schon 
im  Langzeitgedachtnis  existiert,  wobei  die  Verbindung  neu  sein  sollte,  damit  sie  nicht 
mit  anderen  interferiert. 

Ahnlich  wie  bei  einem  Rechner  der  Fetch-Execute-Zyklus  arbeitet  der  Erkennungs- 
Aktions-Zyklus  beim  Menschen.  Der  Inhalt  des  Kurzzeitgedachtnisses  aktiviert  Teile  des 
Inhalts  des  Langzeitgedachtnisses  (Erkennen),  die  wiederum  den  Inhalt  des  Kurzzeitge- 
dachtnisses modifizieren  (Aktion),  was  den  Zustand  fiir  den  nachsten  Zyklus  festlegt.  Der 
Erkennungsprozessor  hat  dabei  eine  Zykluszeit  von  70  ms.  Sie  variiert  allerdings  und 
hangt  unter  anderem  von  der  gestellten  Aufgabe  ab.  Die  Zeit  kann  durch  Ubung,  vermin- 
derte  Anforderung  an  Genauigkeit  oder  groBere  Bemiihungen  des  Benutzers  verkiirzt 
werden. 

Dies  beendet  die  einfiihrende  Beschreibung  des  Modells  „Mensch-als-Prozessor“.  Zu- 
sammenfassend  ist  zu  sagen:  Das  Modell  besteht  aus  einer  Menge  interagierender  Spei- 
cher  und  Prozessoren  und  einer  Menge  von  Speichercodierungstypen.  Jeder  Prozessor 
hat  eine  bestimmte  Zykluszeit,  die  jeweils  etwa  eine  zehntel  Sekunde  betragt. 

Ein  solch  einfaches  Modell  wird  naturlicherweise  nicht  der  Reichhaltigkeit  und  der  Fein- 
heit  des  menschlichen  Geistes  gerecht.  Aber  es  hilft  uns  wenigstens  etwas  dabei,  die 
menschliche  Durchfiihrung  von  Aufgaben  zu  verstehen,  vorherzusagen  oder  sogar  zu  be- 
rechnen,  zumindest  was  die  Mensch-Maschine-Interaktion  angeht. 
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5.1.3  Weitere  Gesetze  und  Prinzipien 

Bei  der  Durchfiihrung  von  Aufgaben  agiert  der  Mensch  nach  bestimmten  Gesetzen,  die 
hier  dargelegt  werden  sollen.  Daraus  konnen  Folgerungen  fiir  die  Implementierung  effi- 
zienter  Mensch-Maschine-Schnittstelllen  abgeleitet  werden.  Der  Einfachheit  halber  wer- 
den die  Formeln  mit  Worten  umschrieben. 

a)  Das  Gesetz  der  Ubung 

Die  Zeit,  eine  gestellte  Aufgabe  zu  losen,  verringert  sich  exponentiell  mit  der  Anzahl  der 
Versuche.  Dieses  Prinzip  wird  auch  das  Lernprinzip  des  Wahrnehmungs-  und  Motor- 
Prozessors  genannt.  Jeder  von  uns  hat  dies  wohl  schon  erlebt,  wenn  immer  gleiche  wie- 
derkehrende  Worte  auf  einer  Tastatur  eingegeben  werden  miissen.  Die  Eingabe  dieser 
Worte  geht  mit  der  Zeit  immer  schneller  vonstatten.  Dies  gilt  zumindest  bei  einem  unge- 
iibten  Benutzer,  der  mit  Hilfe  des  Ein-Finger-Suchsystems  arbeitet. 

Ein  Beispiel:  Ein  Schaltpult  hat  zehn  Lampchen,  unter  denen  sich  zehn  Tasten  befmden. 
Je  nachdem,  welches  Lampchen  aufleuchtet,  mufi  der  Benutzer  die  entsprechende  Taste 
driicken.  Wenn  er  fur  den  lOOOsten  Versuch  beispielsweise  1,48  Sekunden  benotigt  und 
fur  den  2000sten  Versuch  1.15  Sekunden,  so  kann  man  sich  ausrechnen,  wie  lange  er 
fiir  den  SOOOOsten  Versuch  benotigen  wird.  Es  sind  dies  nach  der  Formel  fiir  das  Expo- 
nentialgesetz  0,37  Sekunden.  Experimente  haben  diese  Werte  bestatigt. 

Das  Exponentialgesetz  der  Ubung  spielt  eine  groBe  Rolle  bei  der  Arbeit  an  der  Tastatur 
und  hat  mehrere  praktische  Konsequenzen  (s.u.). 

b)  Das  Unsicherheitsprinzip 

MuB  der  Anwender  eine  Wahl  zwischen  verschiedenen  Alternativen  treffen,  so  erhdht 
sich  die  Reaktionszeit,  d.h.  die  Zeit  bis  zum  Treffen  der  Entscheidung,  mit  der  Anzahl 
der  Alternativen. 

Der  Grund  dafiir  ist  die  Zykluszeit  des  kognitiven  Prozessors  (70  ms),  die  fiir  jede  Alter- 
native anfallt.  Allerdings  verwertet  man  die  Alternativen  meist  in  Gruppen.  Man  ent- 
scheidet  sich  zuerst  fur  eine  Gruppe,  dann  fiir  eine  Untergruppe  usw.  Durch  diese  fortge- 
setzte  Zerteilung  (z.B.  Halbierung)  ergibt  sich  keine  lineare  Gleichung,  sondern  eine 
logarithmische  (Hick’s  Gesetz). 

Etwas  anders  sieht  es  aus,  wenn  die  Alternativen  nicht  gleichgewichtig  sind,  d.h.  wenn 
sie  eine  unterschiedliche  Auftrittswahrscheinlichkeit  haben. 

Ein  Beispiel:  Ein  Telefon-Verteiler  hat  10  Knopfe.  Wenn  eines  der  Lampchen  an  den 
Knopfen  angeht,  so  muB  eine  Sekretarin  den  Knopf  driicken  und  den  Anruf  beantworten. 
Wie  groB  ist  der  prozentuelle  Unterschied  in  der  Reaktionszeit,  wenn  (1)  jedes  der  Lamp- 
chen gleich  haufig  aufleuchet  und  (2)  zwei  der  Lampchen  zu  50%  und  40%  aufleuchten 
und  der  Rest  zu  10  %? 
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Nach  dem  Gesetz  von  Hick  wird  fur  Fall  1 eine  Unsicherheit  von  3,46  ausgerechnet  und 
fiir  Fall  2 von  2,14.  Als  prozentueller  Unterschied  ergibt  sich  2,14/3,46  = 62%.  Das 
bedeutet,  daB  in  Fall  2 gegeniiber  Fall  1 die  Sekretarin  nur  62%  der  Zeit  benotigt. 

Das  Prinzip  sollte  beim  Design  der  Meniiauswahl  und  von  Dialogboxen  einer  GEM- 
Applikation  beriicksichtigt  werden,  da  es  EinfluB  auf  die  Reaktionszeit  des  Benutzers  hat. 

c)  Vergessen  von  gerade  erhaltener  Information 

Je  nachdem,  wo  Information  aktuell  gespeichert  ist,  erreicht  die  Halbwertszeit,  wie  oben 
gesehen,  Werte  von  200  ms  (Wahrnehmungsspeicher),  7000  ms  (Kurzzeitgedachtnis)  und 
unendlich  (Langzeitgedachtnis)  oder,  wenn  die  Verhaltnisse  gekiirzt  werden, 
l:35:unendlich.  Dies  bedeutet,  daB  die  Wiedergewinnungsstrategie  davon  abhangt,  zu 
welchem  Zeitpunkt  die  Information  aufgenommen  wurde.  Dies  entscheidet  dann,  aus 
welchem  Gedachtnis  die  Information  geholt  werden  kann. 

Fur  die  Wiedergewinnung  von  Information,  die  einige  Sekunden  nach  der  Speicherung 
passiert,  kann  das  Kurz-  oder  das  Langzeitgedachtnis  herangezogen  werden  (oder  bei- 
des).  Nach  einigen  Minuten  kann  allerdings  nur  noch  das  Langzeitgedachtnis  „befragt“ 
werden. 

Beispiel:  Einem  Programmierer  werden  verbal  ein  Dutzend  Dateinamen  genannt,  die  er 
in  sein  System  laden  soil.  Wie  soil  der  Programmierer  unter  der  Annahme,  daB  alle  Na- 
men  verschieden  sind  und  nicht  aus  sinnlosen  Silben  bestehen  (also  nicht  XSDFGRO 
etc.),  die  Dateinamen  aufschreiben,  um  moglichst  selten  nachfragen  zu  miissen? 

Da  die  Kapazitat  des  Kurzzeitgedachtnisses  mit  zwolf  Symbolen  uberlastet  ist,  wird  er 
einige  Namen  vergessen.  Beim  Versuch,  sich  zu  erinnern,  wird  aber  das  Kurzzeitgedacht- 
nis belastet,  was  ein  weiteres  Vergessen  bewirkt.  Die  Losung  besteht  darin,  daB  der  Pro- 
grammierer zuerst  versuchen  sollte,  die  zuletzt  genannten  Namen  aufzuschreiben.  Diese 
befmden  sich  noch  im  Kurzzeitgedachtnis.  Die  erstgenannten  befinden  sich  — wenn  uber- 
haupt  — nur  noch  im  Langzeitgedachtnis. 

Natiirlich  hangt  dieses  Beipiel  stark  von  den  Namen  der  Dateien  ab.  Haben  diese  bei- 
spielsweise  Namen  wie  INITl,  INIT2,  ...,  INIT12,  so  wird  kein  Mensch  Probleme  ha- 
ben, all  diese  aus  dem  Gedachtnis  aufzuschreiben,  da  er  sich  nur  zwei  Symbole  merken 
muB:  INIT  und  die  Regel  fiir  die  Numerierung  (bis  einschlieBlich  12). 

Noch  ein  Beispiel:  Wie  lange  kann  ein  Benutzer  verweilen,  um  den  Dateinamen  CAT 
vollstandig  zu  schreiben,  im  Gegensatz  zum  Dateinamen  TXD? 

Da  TXD  keinen  Sinn  macht,  besteht  der  Name  aus  drei  Symbolen  (Buchstaben).  Drei 
Symbole  verschwinden  im  Schnitt  nach  7 Sekunden  aus  dem  Kurzzeitgedachtnis.  Bei  nur 
einem  Symbol  (CAT  wird  z.B.  mit  Katze  assoziiert)  sind  es  73  Sekunden,  so  daB  die  Ver- 
weilzeit  das  zehnfache  betragt. 
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Auch  das  letzte  Beispiel  zeigt,  daB  es  das  Kurzzeitgedachtnis  erheblich  entlastet,  wenn 
bedeutungsvolle  Namen  gewahlt  werden.  Dies  umso  mehr,  da  jene  auch  leichter  ins 
Langzeitgedachtnis  aufgenommen  werden  konnen. 


d)  Interferenz  im  Kurzzeitgedachtnis 

Interferenz  bedeutet  Uberlagerung  (hier  durch  Ahnlichkeit).  Werden  Symbole  im  Kurz- 
zeitgedachtnis mit  anderen  Symbolen  iiberlagert,  so  wird  es  schwieriger,  die  Symbole  zu 
trennen  und  damit  wiederzugewinnen  (siehe  auch  das  Unterscheidungsprinzip).  Die  Ahn- 
lichkeit von  zwei  Symbolen  im  Gedachtnis  hangt  von  der  geistigen  Representation  der 
Symbole  ab.  Diese  wiederum  hangt  von  dem  Gedachtnis  ab,  in  dem  sich  das  Symbol  be- 
findet.  Die  beiden  wichtigsten  Uberlagerungsformen  sind  akustische  (visuelle)  und  se- 
mantische  Interferenz.  Symbole  im  Kurzzeitgedachtnis  sind  gewdhnlicherweise  anfalliger 
fur  akustische  bzw.  visuelle  Interferenz  (sie  werden  gerne  mit  anderen  Symbolen  ver- 
wechselt,  die  ahnlich  klingen  bzw.  aussehen),  da  das  Kurzzeitgedachtnis  gewohnlicher- 
weise  akustische  bzw.  visuelle  Codierung  benutzt.  Symbole  im  Langzeitgedachtnis  sind 
anfalliger  fiir  semantische  Interferenz,  da  das  Langzeitgedachtnis  semantische  Codierung 
benutzt. 

Ein  Beispiel:  In  einem  System  wird  die  Fehlerbehandlung  auf  folgende  Weise  gelost.  Bei 
einem  Systemabsturz  erscheinen  bis  zu  fiinf  Codewbrter  zu  je  drei  Buchstaben  auf  einem 
speziellen  Bildschirm,  die  der  Operator  niederschreiben  (auf  Papier  iibertragen)  muB.  Je- 
des  der  Worter  — es  gibt  insgesamt  sehr  viele  solcher  Worter  — hat  eine  spezielle  Bedeu- 
tung  und  stellt  eine  spezielle  mnemotechnische  Abkiirzung  dar,  die  man  sich  leicht  mer- 
ken  kann.  Was  sollte  eher  vermieden  werden,  Codeworter,  die  ahnlich  klingen  oder 
Codewbrter,  die  eine  ahnliche  Bedeutung  haben? 

Lbsung; 

Da  die  Codewbrter  sofort  niedergeschrieben  werden  miissen,  werden  sie  sich  zum  grbB- 
ten  Teil  im  Kurzzeitgedachtnis  befmden.  Da  sich  das  Kurzzeitgedachtnis  akustischer 
Codierung  bedient,  werden  Ubertragungsfehler  vor  allem  wegen  akustischer  Interferen- 
zen  zwischen  den  Codewbrtern  auftreten.  Daraus  folgt,  daB  ahnlich  klingende  Codewbr- 
ter vermieden  werden  sollten. 


e)  Interferenz  im  Langzeitgedachtnis 

Das  Unterscheidungsprinzip  (s.o.)  sagt  aus,  daB  die  Schwierigkeit,  sich  an  etwas  Be- 
stimmtes  zu  erinnern,  davon  abhangt,  an  welch  andere  Dinge  man  sich  erinnert,  die  durch 
die  gleichen  Zusammenhange  aus  dem  Gedachtnis  geholt  werden. 

Ein  Beispiel:  Ein  Benutzer  ist  dabei,  die  Bedienung  eines  neuen,  z.B.  zeilenorientierten 
Texteditors  zu  erlernen.  Dieser  ist  nahezu  identisch  mit  einem  Editor,  den  er  bereits 
kennt.  Dessen  Kommandos  haben  aber  eine  andere  Syntax  bei  gleicher  Bedeutung  (z.B. 
„ ERASE"  statt  „ DELETE"  fiir  das  Lbschen  einer  Zeile).  Wird  das  Lernen  der  Bedie- 
nung des  neuen  Editors  mit  der  Fahigkeit  des  Benutzers,  sich  an  die  Kommandos  des  alten 
Editors  zu  erinnern,  interferieren? 
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Ja.  Wenn  der  Benutzer  die  Bedienung  des  neuen  Editors  lernt,  gibt  es  neue  Symbole  im 
Gedachtnis,  die  denen  des  alien  Editors  ahneln.  Nach  der  Tatsache  des  Unterscheidungs- 
prinzips  interferieren  diese  mit  Methoden,  die  alien  Befehle  aus  dem  Gedachtnis  zuriick- 
zuholen.  In  der  Tat  ist  es  eine  allgemeine  Erfahrung  fiir  Programmierer,  unfahig  zu  sein, 
sich  zu  erinnem,  wie  das  alte  System  zu  benutzen  war,  obwohl  sie  Hunderte  von  Stunden 
damit  gearbeitet  batten,  nachdem  sie  ein  ahnliches  neues  System  gelernt  batten. 


Bei  meniigesteuerten  Systemen  ist  dieses  Problem  nicht  so  groB,  da  die  Alternativen  auf- 
gezeigt  werden.  Im  einen  Editor  mag  das  Menii  „ERASE“  heiBen,  im  anderen  „DELE- 
TE“.  Da  aber  immer  nur  das  jeweilige  Menu  angezeigt  wird,  gibt  es  keine  Verwechslung. 
Anders  ist  dies  bei  Befehlen,  die  nicht  als  Mentis  auftreten,  so  bei  bildschirmorientierten 
Editoren.  In  einem  Editor  bedeutet  die  Taste  „Pfeil  rechts“  zusammen  mit  „Shift“  das 
Springen  ans  Ende  der  Zeile,  bei  anderen  Editoren  muB  die  Taste  „Control“  statt  „Shift“ 
gedriickt  werden. 


Noch  ein  Wort  zum  Prinzip,  wie  Information  aus  dem  Langzeitgedachtnis  geholt  wird. 
Information  wird  bei  jedem  Zyklus  des  kognitiven  Prozessors  aus  dem  Gedachtnis  geholt. 
Dieses  „Wiederholen“  der  Information  ist  jedoch  nicht  immer  erfolgreich'T  Ist  jedoch  ge- 
nugend  Zeit  verfugbar,  um  das  Gedachtnis  zu  untersuchen,  so  kdnnen  bestimmte  Strate- 
gien  benutzt  werden,  um  das  Langzeitgedachtnis  immer  wieder  zu  untersuchen.  Ein  gutes 
Beispiel  ist  das  Erinnem  an  ein  bekanntes,  aber  selten  benutztes  Kommando. 


Wir  wollen  uns  einmal  vor  Augen  halten,  wie  schwierig  es  fur  einen  Benutzer  ist  zu  ver- 
suchen,  eine  Tatsache  aus  seinem  Langzeitgedachtnis  abzurufen  (Prinzip  der  spezifischen 
Verschlusselung,  s.o.).  Wenn  der  Benutzer  eine  Tatsache  (Symbol,  Merkmal,  etc.)  lernt, 
wird  es  in  irgendeiner  Form  verschlusselt  im  Gedachtnis  abgelegt.  Die  Verschlusselung 
beinhaltet  verschiedene  Hilfsmoglichkeiten,  sich  spater  daran  zu  erinnem.  Zum  Zeit- 
punkt  des  „Sich  Erinnerns"  kennt  der  Benutzer  weder  die  Tatsache  noch  die  Hilfs- 
moglichkeiten. Er  muB  deswegen  raten  oder  vermuten.  Dabei  werden  Hilfsmoglichkeiten 
ins  Kurzzeitgedachtnis  gebracht.  Dort  dienen  sie  beim  nachsten  Zyklus  als  „Ruf“  ins 
Langzeitgedachtnis.  Die  Vermutungen  konnen  nun  gut  sein  und  sofort  zum  Erfolg  fiihren. 
Wenn  nicht,  so  kdnnen  sie  immerhin  Informationen  freilegen,  die  dann  beim  nachsten 
Versuch  zum  Erfolg  fuhren  kdnnen. 


Bei  einem  Versuch  wurden  Versuchspersonen  sieben  Jahre  nach  dem  Abitur  gefragt,  an 
welche  Mitabiturienten  sie  sich  erinnem  kdnnen.  Nach  zehn  Stunden  des  Versuchs,  sich 
zu  erinnem,  konnten  die  Versuchspersonen  immer  noch  Namen  aus  dem  Langzeitge- 
dachtnis zuruckholen.  Ihre  Strategic  war  folgende:  In  Gedanken  suchten  die  Personen 
nach  Gesichtern,  die  sie  auf  fruheren  Parties  gesehen  batten,  gingen  das  Alphabet  durch, 
schlenderten  vertraute  StraBen  hemnter  und  fragten  nach  den  Hausbewohnern.  Je  mehr 
Zeit  sie  batten,  an  desto  mehr  Namen  erinnerten  sie  sich.  Naturlich  fiihrte  dies  nicht  dazu, 
daB  sich  die  Personen  an  alle  Mitabiturienten  erinnerten.  Dies  kann  man  an  einer  Kurve, 
deren  Absizze  die  Stunden  und  deren  Ordinate  die  Anzahl  der  Mitabiturienten  angeben, 
beobachten.  Sie  nahert  sich  asymptotisch  einem  Grenzwert. 
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f)  Das  Rationalitatsprinzip 

Ein  Anwender  versucht,  seine  Ziele  dadurch  zu  erreichen,  daB  er  die  Dinge  tut,  die  tat- 
sachlich  benotigt  werden,  um  die  Aufgabe  selbst  zu  losen.  Ein  GroBteil  der  Komplexitiit 
des  menschlichen  Verhaltens  laBt  sich  nicht  auf  die  Komplexitat  des  Menschen  als  solchen 
zuriickfuhren  (er  versucht  lediglich,  seine  Aufgabe  zu  losen),  sondern  auf  die  Komplexi- 
tat der  Umgebung,  in  der  die  Aufgabe  gestellt  wird.  Daraus  folgt,  daB,  um  das  menschli- 
che  Verhalten  sowohl  zu  verstehen  als  auch  einigermaBen  vorhersehen  zu  konnen,  die 
Aufgabe  analysiert  werden  muB.  Damit  werden  die  verschlungenen  Pfade  des  rationellen 
Verhaltens  entdeckt.  Wir  kommen  daher  zu  dem  Phanomen,  das  man  auch  das  Funda- 
mentalprinzip  der  Aufgabenanalyse  nennt. 

Das  Rationalitatsprinzip:  Ein  Benutzer  versucht,  eine  gestellte  Aufgabe  durch  rationale 
Aktionen  zu  losen,  wobei  die  Struktur  der  Aufgabe  und  die  Informationen,  die  er  erhalt, 
gegeben  sind.  Eingegrenzt  wird  sein  Handeln  von  seinem  Wissen  und  seinen  Fahigkeiten, 
d.h: 


Ziele  + Aufgabe  + Operatoren  -I-  Eingabeinformation  -1-  Wissen  -I-  Fahigkeiten 
> Verhalten. 

Das  Prinzip  bietet  eine  Menge  von  Formulierungen  an,  die  benutzt  werden  konnen,  um 
das  Verhalten  einer  Person  voraussagen  zu  konnen.  Die  ersten  drei  Faktoren  (Ziel,  Auf- 
gabe, Operatoren)  geben  die  objektive  Situation  an,  die  anderen  zeigen  etwas  verstecktere 
Zwange  auf,  namlich  was  der  Benutzer  erkennt,  was  er  weiB  und  wie  er  etwas  berechnen 
kann. 


g)  Das  Prinzip  des  Problemraumes 

Rationelles  Verhalten  kann  oft  praziser  beschrieben  werden.  Angenommen,  eine  Person 
hat  das  Ziel,  ein  Theorem  mit  Hilfe  der  Regeln  der  symbolischen  Logik  zu  beweisen. 
Dann  gibt  es  eine  Menge  von  mentalen  Zustanden,  durch  die  sie  geht.  Beschreibbar  sind 
sie  in  Termen  von  symbolischen  Ausdriicken.  AuBerdem  gibt  es  eine  Anzahl  von  Opera- 
toren, mit  deren  Hilfe  man  von  einem  Zustand  in  einen  anderen  kommt.  Diese  Menge 
von  Zustanden  und  dazugehdrigen  Operatoren  nennt  man  auch  den  Problemraum. 

Das  Prinzip  des  Problemraums:  Das  rationale  Losen  eines  Problems  kann  auf  folgende 
Art  beschrieben  werden:  Es  existieren 

— eine  Menge  von  Wissenszustanden 

— Operatoren,  die  einen  Zustand  in  einen  anderen  iiberfiihren 

- Regeln  der  anzuwendenden  Operatoren 

- Wissen  ura  die  Entscheidung,  welcher  Operator  jeweils  als  nachstes  benutzt  wird 

Es  gibt  verschiedene  Problemraume  fiir  verschiedene  Aufgaben,  und  es  gibt  auch  Ande- 
rungen  in  einem  Problemraum  mit  der  Zeit,  wenn  der  Benutzer  mehr  Erfahrung  iiber  die 
Struktur  der  Aufgabe  erlangt. 
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Ein  Beispiel  ist  das  Ldsen  eines  verschliisselten  arithmetischen  Puzzles.  Dabei  wird 
sowohl  der  Verstand  als  auch  eine  Trial-And-Error-Methode  benutzt. 

DONALD 
+ G E R A L D 


ROBERT  D = 5 

Die  obigen  Buchstaben  sollen  durch  Ziffern  von  0 bis  9 ersetzt  werden,  Gleiche  Buchsta- 
ben  bedeuten  gleiche  Ziffern.  Unterschiedliche  Buchstaben  reprasentieren  unterschied- 
liche  Ziffern.  Das  Ergebnis  soil  eine  mathematisch  korrekte  Addition  sein.  D ist  vorgege- 
ben  als  5. 

Es  sind: 

Zustande:  Zuweisungen  von  Ziffern  an  Buchstaben 
Operatoren: 

— „Weise  zu“  (einetn  Buchstaben  eine  Ziffer) 

— „Untersuche  eine  Spake" 

— „Erzeuge  mogliche  Ziffern"  (von  Buchstaben) 

— „Teste  Ziffer" 

Regeln:  D + D = T etc. 

Wahrend  der  Losung  des  Problems  kann  sich  der  Problemraum  andern,  da  mehr  Wissen 
iiber  die  gestellte  Aufgabe  zusammengetragen  wird.  Es  wird  nun  wichtig  sein,  die  Menge 
der  Zustande  und  Operatoren  ausreichend  klein  zu  halten. 


5.2  Folgerungen 

Die  oben  ausgefiihrten  theoretischen  Abhandlungen  sind  die  Grundlage  der  Folgerungen, 
die  fiir  die  Implementierung  von  Software  unter  einer  grafischen  Benutzeroberflache  wie 
GEM  getroffen  werden  konnen.  Es  hat  sich  gezeigt,  dab  beim  Einhalten  bestimmter  Re- 
geln die  Benutzerschnittstelle  effizienter  wird.  Durch  den  Versuch,  das  Verhalten  des  Be- 
nutzers  vorauszusehen,  werden  Entscheidungen  erleichtert,  die  er  zu  treffen  hat. 

Die  Benutzerschnittstelle  muB  schnell  und  konsistent  sein,  um  den  Anwender  nicht  von 
der  eigentlichen  Arbeit  abzulenken. 

Die  Folgerungen  beziehen  sich  zwar  beispielmaUig  auf  die  grafische  Benutzeroberflache 
GEM  bzw.  X/GEM,  die  auf  einem  ATARI  ST/TT  oder  MS-DOS-  bzw.  FlexOS-Rechner 
zur  Verfiigung  steht.  Sie  gelten  aber  im  Prinzip  auch  fiir  andere  (grafische)  Benutzerober- 
flachen. 
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5.2.1  Meniis 

Die  Kapazitat  des  Kurzzeitgedachtnisses  begrenzt  die  Anzahl  der  Wahlmoglichkeiten,  die 
ein  Benutzer  auf  einen  Blick  erfassen  kann.  Die  Anzahl  sollte,  wie  schon  oben  ausgefiihrt, 
niemals  die  Zahl  sieben  iibersteigen.  Wird  dieses  Gesetz  verletzt,  dann  muB  der  Anwen- 
der  mehrere  Male  auf  die  Meniiauswahl  blicken  und  dabei  pausieren,  urn  sich  zu  uberle- 
gen,  welche  Auswahl  er  treffen  soli. 

Kann  die  Anzahl  der  Mentis  nicht  verringert  werden,  so  sollten  zumindest  logische  Unter- 
gruppen  von  Meniis  gebildet  werden.  Diese  Untergruppen  werden  dann  vom  Benutzer 
wie  ein  Symbol  erkannt,  so  daB  sich  die  Kapazitat  erhoht.  Auf  dieselbe  Weise  geht  das 
menschliche  Gehirn  vor,  das  sich  einen  Satz  weniger  uber  die  einzelnen  Buchstaben,  son- 
dern  mehr  iiber  die  Wbrter  in  diesem  Satz  merken  kann. 

Die  Meniizeile  selbst,  die  von  GEM  zur  Verfiigung  gestellt  wird,  ist  ein  gutes  Beispiel 
fiir  Symbolgruppen.  Unter  den  einzelnen  Menus  verbergen  sich  wiederum  Meniipunkte. 
Wiirden  alle  Meniipunkte  auf  einmal  angezeigt,  dann  wiirde  das  Kurzzeitgedachtnis  iiber- 
lastet  werden. 

Als  Beispiel  kann  hier  der  Meniieintrag  „File“  des  Textsystems  Wordplus  herangezogen 
werden.  Er  unterteilt  sich  in  5 Untergruppen,  die  jeweils  logisch  zusammengehoren 
(Abb.  5.3).  Dort  kann  aber  noch  mehr  abgelesen  werden:  Meniieintragen,  bei  denen  beim 
Anwahlen  eine  Dialogbox  folgt,  sollten  3 Punkte  folgen  (z.B.  „Gffnen...“).  Der  Benutzer 
kann  sich  dann  schon  darauf  einstellen,  daB  in  der  Mine  des  Bildschirms  eine  Dialogbox 
erscheinen  wird,  indem  er  sich  mit  der  Mans  vom  Meniieintrag  in  die  Bildschirmmitte 
bewegt,  wahrend  diese  aufgebaut  wird.  Diese  3-Punkte-Regel  wird  iibrigens  von  Tim 
Oren  empfohlen,  der  das  GEM  maBgeblich  mitentwickelt  hat. 


Open. . . 

''0 

Print... 

Print  Current... 

^P 

Saue  and  Ciose 

Saue  and  Resume 

Saue  as . . . 

Read . . . 

"R 

lUi  i to  RIotk.  . . 

-)U 

Delete. . . 

"D 

Quit.  . . 

Quit  fli 1 . . . 

"Q 

Abbildung  5.3:  „File“-Meniipunkt  in  Wordplus  3.14 
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Ein  schlechtes  Beispiel  ist  der  Aufbau  des  Menus  „Text“  bei  Tempus  2.0  (Abb.  5.4). 
Es  ist  total  iiberladen  (13  Meniipunkte,  davon  12  hintereinander).  Auberdem  bestehen  die 
einzelnen  Meniipunkte  aus  zu  vielen  Buchstaben  so  dal)  zu  viel  Gesamttext  im  Drop- 
Down-Menii  steht. 


Teat 


Zeichenkette  suchen... 
Suchen  iviederholen 
Suchen  O'  Erset2en. . . 
Querueriveis  I iste. . . 
Zeichenkonuers ion. . . 

Ze i I en  sor  t i eren . . , 
Tentuergleich 
Tent  drucken 
Zeichenredundanz 
Tent  anpassen 
Tent  ref ormat ieren 
Rbsatz  ref ormat ieren 


Tent  el iminieren 


Abbildung  5.4:  „Text“-Menii  in  Tempus  2.0 


Ein  Benutzer,  der  daraus  einen  Meniipunkt  auswahlen  mochte,  mul)  standig  fast  den  kom- 
pletten  Text  eines  Drop-Down-Meniis  lesen,  da  das  erste  Wort  zum  Grobteil  redundant 
ist.  Es  handelt  sich  meist  um  „Text“.  So  heibt  aber  auch  das  Menti.  Wiirde  man  im  Text- 
Menu  nur  solche  Punkte  unterbringen,  die  tatsachlich  mit  dem  Wort  „Text“  beginnen, 
so  konnte  man  sich  dieses  Wort  wiederum  sparen  und  die  Meniipunkte  waren  (in  der  Ho- 
rizontalen)  kiirzer.  Auberdem  befinden  sich  im  Meniipunkt  „Speziell“  noch  die  Punkte 
„Text  expandieren"  und  Text  komprimieren“ . Assoziiert  nun  ein  Benutzer  seine  Tatig- 
keit  „Text  komprimieren“  verstandlicherweise  mit  dem  Oberbegriff  „Text“,  so  sucht  er 
vergeblich  im  Menii  (Text),  welches  nicht  den  gewiinschten  Meniipunkt  bietet. 

Meniis  sollten  einen  Standardaufbau  haben,  damit  sich  ein  Benutzer  beim  Starten  des  Pro- 
gramms  sofort  „heimisch“  fiihlt.  Das  erste  Menii  von  links  (Desk)  auf  dem  Atari  ist  dasje- 
nige  mit  den  Deskaccessories.  Bei  neueren  GEM-Versionen  (2.X,  3.X)  steht  dieses  Menii 
ganz  rechts  und  hat  als  Titel  immer  den  Namen  der  aktuellen  Applikation.  Bei  X/GEM 
gibt  es  keine  Accessories,  da  beliebige  X/GEM-Programme  im  Hintergrund  laufen  kon- 
nen.  Anstelle  der  Accessories  treten  dann  die  Namen  der  gerade  laufenden  Applikationen. 

Wenn  man  mit  vielen  Programmen  arbeitet,  die  teilweise  gleiche  Mentis  aufweisen,  so 
weib  man  mitunter  auf  den  ersten  Blick  nicht,  wie  das  Programm  heibt,  das  gerade  aktiv 
ist.  Bei  den  neueren  GEM-Versionen  einschlieblich  X/GEM  ist  dies,  wie  oben  erwahnt, 
kein  Problem, 

Beim  ST  gibt  es  nun  Programme,  welche  nur  einfach  „Desk“  als  ersten  Punkt  in  ihrer 
Meniizeile  haben,  andere  benutzen  das  Atari-Symbol.  Am  besten  wird  jedoch  auch  in  die- 
sen  Programmen  der  Name  ohne  Suffix  in  die  Meniizeile  gebracht.  Dann  erkennt  man 
sofort,  wie  das  aktive  Programm  heibt. 
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Zu  dem  Menii  ist  nur  soviel  zu  sagen,  daB  die  Applikation  moglichst  so  sauber  program- 
miert  wird,  dali  Deskaccessories  zugelassen  werden.  Es  gibt  auch  Programme,  die  die 
Deskaccessories  ausblenden  (Signum,  STAD).  Deskaccessories  haben  selbst  keine  Menii- 
zeile.  Bei  groBen  Accessories  ist  dies  bisweilen  aber  wiinschenswert,  ebenso  bei  Pro- 
grammer!, die  wahlweise  als  Applikation  und  als  Accessory  laufen  kdnnen.  Damit  man 
die  Bedienung  eines  solchen  Accessories  beibehalten  kann,  wird  in  Kapitel  6 eine  Routine 
vorgestellt,  die  eine  Meniizeile  fur  ein  Accessory  in  ein  Fenster  legt.  Dadurch  kann  eine 
Applikation,  die  als  Accessory  im  Hintergrund  lauft,  praktisch  genauso  bedient  werden 
wie  das  Programm.  Es  muB  kein  Byte  im  Programm  umgeschrieben  werden,  damit  dies 
funktioniert.  Die  vorgestellten  Routinen  erledigen  dies  automatisch. 

Der  zweite  Meniititel  sollte  immer  „Datei“  oder  „File“  heiBen.  In  ihm  sollten  sich  Menii- 
punkte  befinden,  mit  denen  die  Ein/Ausgabe  geregelt  wird.  Beispiele  sind  der  GEM 
Desktop  und  das  Resource  Construction  Set.  (s.  Abb.  5.5). 


ORTEI 


dffne 

ze ige  Info . . . 


neuer  Ordner 
sch I i efle 

sch I i efle  F ens ter 


tormat iere. . . 


File 


Neui  ‘IV 
Open ...  ‘0 
Merge...  ‘N 


Close  ‘C 
Saue  ‘U 
Saue  Hs . . . *M 
Rbandon  ‘R 


Quit  ‘0 


GEM  Desktop 


Resource  Construction  Set 


Abbildung  5.5:  Datei-Meniis  des  GEM  Desktop  und  des  Resource  Construction  Sets. 


Zu  den  Meniipunkten  sollten  moglichst  immer  gehoren: 

Neu  (New):  Ein  neues  Dokument  (Resource-Datei,  etc.)  wird  geoffnet.  Einen  Namen  be- 
kommt  das  Dokument  dann  beim  erstmaligen  Speichern.  Kann  kein  neues  Dokument  ge- 
offnet werden,  muB  der  Menupunkt  abgeschaltet  (grau)  sein.  Auf  diesen  Meniipunkt  kann 
verzichtet  werden,  wenn  beim  Offnen  (s.u.)  bereits  ein  Name  gewahlt  wird,  der  vorher 
nicht  da  war. 

Offnen...  (Open...):  Offnet  ein  existierendes  Dokument  (Resource-Datei,  Programm 
etc.)  Oder  ein  Objekt,  welches  selektiert  ist.  Bei  Bedarf  erscheint  die  Datei-Auswahl-Box, 
in  welcher  der  Benutzer  eine  Datei  auch  auf  einem  anderen  Laufwerk  auswahlen  darf. 

SchlieBen  (Close):  SchlieBt  das  oberste  Fenster  und  ein  damit  eventuell  zusammenhan- 
gendes  Dokument  (Resource-Datei,  etc).  Wurde  eine  Anderung  an  dem  durch  das  Fenster 
reprasentierten  Objekt  gemacht,  so  muB  dem  Benutzer  die  Gelegenheit  gegeben  werden. 
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das  SchlieBen  abzuwenden.  Dieselben  Aktionen  laufen  ab,  wenn  der  Benutzer  in  das 
Schliefikastchen  klickt.  Wird  ein  Fenster  geschlossen,  ohne  daB  der  Text  verlorengeht, 
so  kann  eine  Sicherheitsabfrage  zunachst  entfallen.  Es  muB  dann  aber  die  Moglichkeit 
bestehen,  das  entsprechende  Fenster  wieder  zu  offnen.  Dazu  muB  das  Fenster  in  ein  Icon 
umgewandelt  werden.  Dieses  kann  dann  durch  Anklicken  wieder  geoffnet  werden.  Ein 
Beispiel  hierzu  ist  das  in  Kapitel  6 vorgestellte  Demoprogramm,  aber  auch  z.B. 
TEMPUS. 

Info...  (Info...):  Zeigt  eine  spezifische  Information  an.  Ist  ein  Objekt  selektiert,  so  wird 
dessen  Information  angezeigt,  ansonsten  Information  uber  das  aktive  Fenster.  Ist  kein 
Fenster  aktiv  (offen),  so  wird  Programminformation  angezeigt. 

Hilfe...  (Help...):  Zeigt  einen  spezifischen  Hilfstext  an.  Ist  ein  Objekt  selektiert,  so  wird 
dessen  Hilfstext  angezeigt,  ansonsten  Hilfstext  uber  das  aktive  Fenster.  Ist  kein  Fenster 
bzw.  nur  der  Desktop  aktiv  (offen),  so  wird  allgemeiner  Hilfstext  iiber  das  Programm 
angezeigt.  Dieser  Meniipunkt  kann  eventuell  entfallen,  wenn  ein  eigenes  Hilfe-Menu  exi- 
stiert  (wie  z.B.  bei  Turbo  C). 

Sichern  (Save):  Sichert  ein  Dokument  (eine  Resource-Datei,  eine  Grafik,  etc.).  Bei  neuen 
Dokumenten  wird  zuerst  noch  nach  einem  Namen  gefragt,  da  dieser  noch  nicht  vergeben 
ist.  Als  Alternative  kann  auch  der  Meniipunkt  abgeschaltet  und  nur  ein  „Sichern  als...“ 
erlaubt  sein.  Nach  dem  Sichern  bleibt  das  Dokument  geoffnet. 

Sichern  als...  (Save  as...):  Sichert  eine  Kopie  des  aktiven  Dokuments.  Dabei  erscheint 
die  Datei-Auswahl-Box,  uber  die  der  Benutzer  den  Namen  eingeben  kann.  Nach  dem 
Beenden  der  Funktion  sollte  sich  der  Name  des  Dokuments  (Fenster-Titel)  andern,  so  daB 
ab  nun  der  neu  eingegebene  Name  beim  nachsten  Sichern  beriicksichtigt  wird. 

Drucken...  (Print...):  Druckt  ein  Dokument  oder  das  aktive  Fenster.  Vorher  kdnnen  in 
einer  Dialogbox  druckerspezifische  Parameter  wie  z.B.  Anzahl  der  Kopien  etc.  einge- 
stellt  werden. 

Datei  loschen...  (Delete  File...):  Optional  kann  ein  Meniipunkt  vorgesehen  werden,  um 
eine  Datei  zu  loschen.  Dies  gilt  vor  allem  fiir  Applikationen,  die  Backups  von  Dokumen- 
ten auf  Diskette  speichem  und  somit  die  Moglichkeit  geben  wollen,  diese  zu  loschen,  falls 
das  Original  nicht  mehr  auf  die  Diskette  paBt. 

Disk  formatieren...  (Format  Disk...):  Das  Formatieren  von  Disketten  aus  einem  Pro- 
gramm soil  vor  allem  dazu  dienen,  auftretende  Probleme  beim  Abspeichern  von  Doku- 
menten auf  gefullte  Datentrager  zu  umgehen.  Man  stelle  sich  eine  Situation  vor,  in  der 
ein  wichtiges  Dokument  nicht  mehr  abgespeichert  werden  kann,  weil  keine  Diskette  mit 
geniigend  Speicherplatz  zur  Verfiigung  steht.  MuB  man  dann  das  Programm  verlassen, 
um  eine  Diskette  zu  formatieren,  so  geht  das  Dokument  verloren.  Der  Meniipunkt  kann 
entfallen,  wenn  das  Formatieren  auch  bei  Ablauf  eines  anderen  Programms  mdglich  ist. 
Dies  ist  z.B.  bei  FlexOS  der  Fall,  wo  man  jederzeit  einen  anderen  ProzeB  starten  und 
von  dort  formatieren  kann. 
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Beenden  (Quit):  Der  letzte  Meniipunkt  sollte  immer  „Beenden“  oder  „Verlassen“  lauten. 
Warden  Dokumente  geandert,  so  sollte  der  Benutzer  dazu  aufgefordert  werden,  diese 
vorher  abzuspeichern. 


Der  dritte  Meniititel  sollte  immer  „Bearbeiten“  (Edit)  lauten.  In  ihm  befinden  sich  unter 
anderem  die  Befehle: 


Undo:  Die  letzte  Anderung  wird  ruckgangig  gemacht. 


Ausschneiden  (Cut):  Der  vorher  ausgewahlte  Block  wird  ausgeschnitten  und  aus  dem  Ori- 
ginal entfernt.  Der  Block  wird  vorher  in  einen  Zwischenspeicher  gerettet,  um  ein  „Undo“ 
Oder  ein  „Einfugen“  moglich  zu  machen. 


Kopieren  (Copy):  Wie  „ Ausschneiden",  aber  ohne  Loschen  des  Originals. 

Einfiigen  (Paste):  Der  vorher  ausgeschnittene  oder  kopierte  Teil  wird  an  der  aktuellen 
Cursorposition  eingefiigt.  Die  Operation  kann  mehrere  Male  hintereinander  ausoefuhrt 
werden. 

Loschen  (Clear):  Wie  „ Ausschneiden",  jedoch  ohne  Speicherung  des  Blocks. 


Alles  auswahlen  (Select  all):  Das  gesamte  Dokument  wird  ausgewahlt.  Dies  entspricht 
z.B.  bei  Textdateien  einem  Blockanfang  am  ersten  Buchstaben  der  ersten  Zeile,  einem 
Blockende  am  letzten  Buchstaben  der  letzten  Zeile. 


Zusatzlich  konnen  sich  Befehle  zum  Speichern  auf  eine  Zwischenablage  (Klemmbrett 
Oder  Clipboard)  in  diesem  Menu  befinden  (s.  Kap.  5.5).  In  unserer  Beispielapplikation 
werden  dazu  die  gleichen  Mentis  verwendet.  Ein  Schalter  („  Auf  GEM-Klemmbrett“)  gibt 
dann  an,  ob  die  Operationen  im  schnellen  Arbeitsspeicher  oder  auf  dem  langsamen,  aber 
residenten  GEM-Klemmbrett  stattfinden. 


Beim  Einsatz  der  Icon-Technik  konnen  einige  der  o.g.  Meniipunkte  auf  Icon-Funktionen 
zuriickgefiihrt  werden.  Angenommen,  man  hat  Standard-Icons  wie  Papierkorb,  Drucker, 
Diskette,  Klemmbrett  sowie  Icons  fur  Dokumente  (s.  Abb.  5.6). 
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Abbildung  5.6:  Standard-Icons 


Dann  ist  es  moglich,  durch  Modifizieren  der  Icons  bestimmte  Funktionen  aufzurufen. 

Offnen:  Alle  Icons  sollten  gedffnet  werden  konnen.  Der  Papierkorb  zeigt  die  zuletzt  ge- 
loschten  Inhalte,  der  Drucker  zeigt  eine  Druckereinstellungsbox,  die  Diskette  den  Disket- 
teninhalt,  das  Klemmbrett  das  GEM-Clipboard  und  die  Dokumente  deren  Inhalt. 

Folgende  Operationen  konnen  noch  moglich  sein: 

Ziehen  der  Diskette: 

— auf  den  Papierkorb;  Loschen  einer  Datei 

— auf  den  Drucker;  Drucken  einer  Datei 

— auf  das  Klemmbrett:  Kopieren  einer  Datei  ins  GEM-Clipboard 

— auf  das  Dokument:  Laden  einer  Datei 

Ziehen  des  Klemmbretts: 

— auf  den  Papierkorb:  Loschen  des  GEM-Clipboards 

— auf  den  Drucker;  Drucken  des  GEM-Clipboards 

— auf  die  Diskette:  Kopieren  des  GEM-Clipboards  in  eine  Datei 

— auf  das  Dokument:  Einlesen  des  GEM-Clipboards  in  ein  Dokument 

Ziehen  eines  Dokuments: 

— auf  den  Papierkorb:  Loschen  des  Dokuments  aus  dem  Speicher 

— auf  den  Drucker;  Drucken  des  Dokuments 

— auf  die  Diskette:  Sichern  des  Dokuments  (Sichern  als...)  • 

— auf  das  Klemmbrett:  Sichern  des  Dokuments  in  das  GEM-Clipboard 

Durch  die  vielfaltigen  Moglichkeiten  des  Ziehens  eines  Objekts  auf  ein  anderes  konnen 
viele  Menupunkte  eingespart  werden.  ' 
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Um  die  Koordination  des  motorischen  Systems  zu  entlasten  (Handbewegung  zwischen 
Tastatur  und  Maus),  sollten  alle  Meniipunkte  zusatzlich  iiber  Tastenkombinationen  aufzu- 
rufen  sein.  Der  Benutzer  kann  dann  wahlen,  wie  er  ein  Menu  lieber  aufrufen  mochte. 
Dabei  sollten  sich  aber  alle  Software-Entwickler  an  einen  gemeinsamen  Standard  halten. 
Im  Prinzip  gibt  es  schon  eine  Art  Standard,  der  aber  nirgends  dokumentiert  ist.  Dies  wird 
hiermit  nachgeholt. 

In  jedem  Menupunkt  soil  sich  der  zugehorige  Tastencode  am  rechten  Rand  desselben  be- 
finden.  An  der  Art  der  Darstellung  kann  der  Benutzer  auf  die  Tastenkombination  schlie- 
Ben.  Es  kdnnen  auftreten  (siehe  Abb.  5.7): 

a)  Normalzeichen  (GroBbuchstaben,  Sonderzeichen) 

b)  Buchstaben  mit  gedriickter  Control-Taste 

c)  Buchstaben  mit  gedriickter  Alternate-Taste 

d)  Funktionstasten  (Normal,  Shift,  Control  oder  Alternate) 


Beispiele 


Normalzeichen  N 
Controlzelchen  *C 
HI  ternatezelchen  Kfl 


Funkt ionstaste  FI 
Shirt-Funkt lonstaste  $F2 
Contro l-Funkt I ons tas te  'FS 


HI ternate-Funkt Ions tas te  SFIB 


Abbildung  5.7:  Meniis  mit  Tastaturanzeige 

Bei  jedem  Menupunkt  sollte  versucht  werden,  den  Anfangsbuchstaben  zu  verwenden. 
Dies  wird  nicht  immer  gelingen,  so  daB  auch  andere  Buchstaben  aus  dem  Kontext  heran- 
gezogen  werden  konnen.  Fur  die  Standardfiinktionen  CUT,  COPY,  PASTE  und  UNDO 
sollten  die  Kombinationen  (X,  C,  V und  Z)  benutzt  werden,  da  dies  in  vielen  Programmen 
schon  auf  diese  Weise  realisiert  wird.  Als  Kombination  bietet  sich  Control  oder  Alternate 
an.  Die  Control-Kombination  hat  sich  als  Standard  bereits  herauskristallisiert.  Da  jedoch 
Control-C  bei  X/GEM  — zumindest  unter  FlexOS  — immer  ein  vorzeitiges  Beenden  des 
Programmes  erwirkt,  konnte  auch  auf  Alternate-Kombinationen  ausgewichen  werden, 
um  die  Kompatibilitat  zwischen  den  Versionen  zu  erhalten. 

Da  fiir  internationale  Versionen  die  Anfangsbuchstaben  der  Meniipunkte  meist  anders 
lauten,  gibt  es  im  Prinzip  zwei  Moglichkeiten:  Man  behalt  die  Tastenkombinationen  bei 
Oder  andert  sie  entsprechend  des  Textes,  der  fiir  das  jeweilige  Land  maBgebend  ist. 

Entwickler  werden  nun  sicher  einwenden,  daB  es  miihsam  ist,  fur  jedes  Land  andere 
Kombinationen  zu  benutzen,  da  diese  im  Programm  entsprechend  abgefangen  werden 
miissen.  Keine  Sorge!  In  den  Funktionen,  die  in  Kapitel  6 angeboten  werden,  befindet 
sich  eine  Routine  (is_menu_key),  die  fur  eine  vorgegebene  Tastenkombination  und  ei- 
nen vorgegebenen  Meniibaum  die  Nummer  des  Meniipunktes  ermittelt  und  zuriickliefert. 
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Dies  bedeutet,  dab  die  Vergabe  von  Tastenkombinationen  von  auben  erfolgen  kann,  nam- 
lich  durch  Angabe  im  Menubaum  in  der  Resource-Datei!  Bei  Anderung  der  Tastenkombi- 
nationen dutch  Ubersetzung  in  andere  Sprachen  ergibt  sich  somit  kein  Zusatzaufwand  fiir 
den  Entwickler,  Man  konnte  sogar  zur  Laufzeit  die  Menupunkte  entsprechend  andern, 
was  bedeutet,  dab  es  auch  keinen  Aufwand  darstellt,  wenn  der  Benutzer  sich  die  Tasten- 
kombinationen selbst  definieren  diirfte. 


5.2.2  Mausbewegungen 

Aus  dem  Gesetz  von  Fitt  (s.o.)  lassen  sich  eine  Menge  von  Informationen  zur  Geschwin- 
digkeitssteigerung  der  Benutzerschnittstelle  ableiten.  Die  Objekte,  die  im  Arbeitsbereich 
liegen,  sollten  sich  eigentlich  in  der  Nahe  der  Bildschirmmitte  befinden,  da  die  Maus  dann 
im  Durchschnitt  eine  kleinere  Strecke  zuruckzulegen  hat,  urn  Objekte  auszuwahlen.  Da 
die  Bildschirmmitte  nicht  unendlich  grob  und  oft  verdeckt  ist  und  zudem  nicht  alle  Objek- 
te dort  Platz  haben,  sollten  zumindest  diejenigen  Objekte,  die  semantisch  zusammengeho- 
ren,  auch  zusammen  plaziert  werden  konnen. 

Am  Beispiel  des  Aufbaus  des  Desktop  im  Datenbanksystem  ADIMENS  ST  soli  obiges 
Gesetz  veranschaulicht  werden.  Dort  konnen  die  Symbole  fiir  die  einzelnen  logischen 
Dateien  einer  Datenbank,  sowie  die  Funktionssymbole  wie  Papierkorb,  Drucker,  Disket 
te  etc.  beliebig  plaziert  werden.  Die  Stellungen  der  Objekte  konnen  abgespeichert  wer- 
den, so  dab  bei  jedem  Neustart  der  gleiche  Desktop  erscheint.  In  Abbildung  5.8  sind  die 
Symbole  fiir  die  Ausgabe  in  einer  Gruppe  zusammengefabt,  wahrend  der  Papierkorb,  der 
zum  Loschen  von  Datensatzen  dient  (gefahrlich),  abseits  plaziert  wurde. 
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Abbildung  5.8:  Der  Desktop  des  Datenbankausfiihrungsteils  EXEC  von  ADIMENS  ST 
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1st  nun  eine  groBe  Menge  von  gleichen  Operationen  durchfuhrbar,  so  kann  das  Funktions- 
Symbol  (z.B.  das  Import/Export-Symbol)  in  die  Niihe  der  Objekte  plaziert  warden,  auf 
die  die  Funktion  angewandt  warden  soli.  Dadurch  konnen  die  Operationen  schneller 
durchgefuhrt  werden,  da  die  Mauswege  kurz  sind. 

Die  Kastchen  (Kndpfe),  in  denen  bei  Dialogboxen  mit  Hilfe  der  Maus  Optionen  und 
Funktionen  ausgewahlt  werden  konnen,  diirfen  nicht  zu  klein  sein,  damit  eine  ausreichen- 
de  Treffsicherheit  gewahrleistet  ist.  AuBerdem  sollte  ein  ausreichender  Zwischenraum 
zwischen  den  Funktionskastchen  sein,  damit  in  den  Randregionen  kein  Positionierungs- 
fehler  auftreten  kann.  In  Abbildung  5.9  sind  die  Kndpfe  „OK“,  „HILFE“  und  „AB- 
BRUCH“  der  oberen  Dialogbox  um  einiges  groBer  als  bei  der  unteren  Dialogbox.  AuBer- 
dem haben  die  Kndpfe  der  unteren  Dialogbox  einen  zu  kleinen  Abstand  zueinander. 


iaIogboH  mi t 


gronen  Knopf en 


OK 

HILFE 

RBBRUCH 

alogboH  mit  kleinen  Knopfen 


I OK  ||  HILFE  IPuBBRUCHI 


Abbildung  5.9:  Kndpfe  in  einer  Dialogbox 


Eine  weitere  Mdglichkeit,  Mauswege  zu  optimieren,  sind  sogenannte  Pop-Up-Meniis.  Sie 
erscheinen  an  der  Stella,  an  der  mit  dem  Mauszeiger  geklickt  wird  (siehe  Abb.  5.10). 
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Dies  bedeutet,  daB  die  Vergabe  von  Tastenkombinationen  von  auBen  erfolgen  kann,  nam- 
lich  durch  Angabe  im  Meniibaum  in  der  Resource-Datei!  Bei  Anderung  der  Tastenkombi- 
nationen dutch  Ubersetzung  in  andere  Sprachen  ergibt  sich  somit  kein  Zusatzaufwand  fiir 
den  Entwickler.  Man  konnte  sogar  zur  Laufzeit  die  Meniipunkte  entsprechend  andern, 
was  bedeutet,  daB  es  auch  keinen  Aufwand  darstellt,  wenn  der  Benutzer  sich  die  Tasten- 
kombinationen selbst  defmieren  diirfte. 


5.2.2  Mausbewegungen 

Aus  dem  Gesetz  von  Fitt  (s.o.)  lassen  sich  eine  Menge  von  Informationen  zur  Geschwin- 
digkeitssteigerung  der  Benutzerschnittstelle  ableiten.  Die  Objekte,  die  im  Arbeitsbereich 
liegen,  sollten  sich  eigentlich  in  der  Nahe  der  Bildschirmmitte  befmden,  da  die  Mans  dann 
im  Durchschnitt  eine  kleinere  Strecke  zuriickzulegen  hat,  um  Objekte  auszuwahlen.  Da 
die  Bildschirmmitte  nicht  unendlich  groB  und  oft  verdeckt  ist  und  zudem  nicht  alle  Objek- 
te dort  Platz  haben,  sollten  zumindest  diejenigen  Objekte,  die  semantisch  zusammengeho- 
ren,  auch  zusammen  plaziert  werden  kdnnen. 

Am  Beispiel  des  Aufbaus  des  Desktop  im  Datenbanksystem  ADIMENS  ST  soil  obiges 
Gesetz  veranschaulicht  werden.  Dort  konnen  die  Symbole  fiir  die  einzelnen  logischen 
Dateien  einer  Datenbank,  sowie  die  Funktionssymbole  wie  Papierkorb,  Drucker,  Disket- 
te etc.  beliebig  plaziert  werden.  Die  Stellungen  der  Objekte  konnen  abgespeichert  wer- 
den, so  daB  bei  jedem  Neustart  der  gleiche  Desktop  erscheint.  In  Abbildung  5.8  sind  die 
Symbole  fur  die  Ausgabe  in  einer  Gruppe  zusammengefaBt,  wahrend  der  Papierkorb,  der 
zum  Loschen  von  Datensatzen  dient  (gefahrlich),  abseits  plaziert  wurde. 
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Abbildung  5.8:  Der  Desktop  des  Datenbankausfiihrungsteils  EXEC  von  ADIMENS  ST 
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1st  nun  eine  groBe  Menge  von  gleichen  Operationen  durchfiihrbar,  so  kann  das  Funktions- 
Symbol  (z.B.  das  Import/Export-Symbol)  in  die  Nahe  der  Objekte  plaziert  werden,  auf 
die  die  Funktion  angewandt  werden  soli.  Dadurch  konnen  die  Operationen  schneller 
durchgefiihrt  werden,  da  die  Mauswege  kurz  sind. 

Die  Kastchen  (Knopfe),  in  denen  bei  Dialogboxen  mit  Hilfe  der  Maus  Optionen  und 
Funktionen  ausgewahlt  werden  konnen,  diirfen  nicht  zu  klein  sein,  damit  eine  ausreichen- 
de  Treffsicherheit  gewiihrleistet  ist.  AuBerdem  sollte  ein  ausreichender  Zwischenraum 
zwischen  den  Funktionskastchen  sein,  damit  in  den  Randregionen  kein  Positionierungs- 
fehler  auftreten  kann.  In  Abbildung  5.9  sind  die  Knopfe  „OK“,  „HILFE“  und  „AB- 
BRUCH“  der  oberen  Dialogbox  urn  einiges  grolier  als  bei  der  unteren  Dialogbox.  AuBer- 
dem haben  die  Knopfe  der  unteren  Dialogbox  einen  zu  kleinen  Abstand  zueinander. 


alogboH  mit  grollen  Knopfen 


OK 

HILFE 

HBBRUCH 

m 


alogboa  mit  kleinen  Knopfen 


I OK  II  HILFE  ||flB8RUCH| 


Abbildung  5.9:  Knopfe  in  einer  Dialogbox 


Eine  weitere  Mdglichkeit,  Mauswege  zu  optimieren,  sind  sogenannte  Pop-Up-Meniis.  Sie 
erscheinen  an  der  Stelle,  an  der  mit  dem  Mauszeiger  geklickt  wird  (siehe  Abb.  5.10). 


310 


5 Gestaltung  von  Benutzeroberfl&chen 


Dies  bedeutet,  daB  die  Vergabe  von  Tastenkombinationen  von  auBen  erfolgen  kann,  nam- 
lich  durch  Angabe  im  Meniibaum  in  der  Resource-Datei!  Bei  Anderung  der  Tastenkombi- 
nationen  durch  Ubersetzung  in  andere  Sprachen  ergibt  sich  somit  kein  Zusatzaufwand  fiir 
den  Entwickler.  Man  konnte  sogar  zur  Laufzeit  die  Meniipunkte  entsprechend  andern, 
was  bedeutet,  daB  es  auch  keinen  Aufwand  darstellt,  wenn  der  Benutzer  sich  die  Tasten- 
kombinationen selbst  definieren  diirfte. 


5.2.2  Mausbewegungen 

Aus  dem  Gesetz  von  Fitt  (s.o.)  lassen  sich  eine  Menge  von  Informationen  zur  Geschwin- 
digkeitssteigerung  der  Benutzerschnittstelle  ableiten.  Die  Objekte,  die  im  Arbeitsbereich 
liegen,  sollten  sich  eigentlich  in  der  N^e  der  Bildschirmmitte  befinden,  da  die  Maus  dann 
im  Durchschnitt  eine  kleinere  Strecke  zuriickzulegen  hat,  um  Objekte  auszuwahlen.  Da 
die  Bildschirmmitte  nicht  unendlich  groB  und  oft  verdeckt  ist  und  zudem  nicht  alle  Objek- 
te dort  Platz  haben,  sollten  zumindest  diejenigen  Objekte,  die  semantisch  zusammengehd- 
ren,  auch  zusammen  plaziert  werden  konnen. 

Am  Beispiel  des  Aufbaus  des  Desktop  im  Datenbanksystem  ADIMENS  ST  soil  obiges 
Gesetz  veranschaulicht  werden.  Dort  konnen  die  Symbole  fur  die  einzelnen  logischen 
Dateien  einer  Datenbank,  sowie  die  Funktionssymbole  wie  Papierkorb,  Drucker,  Disket- 
te etc.  beliebig  plaziert  werden.  Die  Stellungen  der  Objekte  konnen  abgespeichert  wer- 
den, so  daB  bei  jedem  Neustart  der  gleiche  Desktop  erscheint.  In  Abbildung  5.8  sind  die 
Symbole  fur  die  Ausgabe  in  einer  Gruppe  zusammengefaBt,  w^rend  der  Papierkorb,  der 
zum  Loschen  von  Datensatzen  dient  (gefahrlich),  abseits  plaziert  wurde. 
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Abbildung  5.8:  Der  Desktop  des  Datenbankausfiihrungsteils  EXEC  von  ADIMENS  ST 
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1st  nun  eine  groBe  Menge  von  gleichen  Operationen  durchfiihrbar,  so  kann  das  Funktions- 
Symbol  (z.B.  das  Import/Export-Symbol)  in  die  Nahe  der  Objekte  plaziert  werden,  auf 
die  die  Funktion  angewandt  werden  soli.  Dadurch  konnen  die  Operationen  schneller 
durchgefiihrt  werden,  da  die  Mauswege  kurz  sind. 

Die  Kastchen  (Knopfe),  in  denen  bei  Dialogboxen  mit  Hilfe  der  Maus  Optionen  und 
Funktionen  ausgewahlt  werden  konnen,  diirfen  nicht  zu  klein  sein,  damit  eine  ausreichen- 
de  Treffsicherheit  gewahrleistet  ist.  AuBerdem  sollte  ein  ausreichender  Zwischenraum 
zwischen  den  Funktionskastchen  sein,  damit  in  den  Randregionen  kein  Positionierungs- 
fehler  auftreten  kann.  In  Abbildung  5.9  sind  die  Knopfe  „OK“,  „HILFE“  und  „AB- 
BRUCH“  der  oberen  Dialogbox  um  einiges  groBer  als  bei  der  unteren  Dialogbox.  AuBer- 
dem haben  die  Knopfe  der  unteren  Dialogbox  einen  zu  kleinen  Abstand  zueinander. 


DialogboH  mit  groDen  Knopfen 


1 OK 

HILFE 

RBBRUCH 
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alogboH  mi t 


k leinen  Knopf en 


I OK  II  HILFE  ||RBBRUCH| 


Abbildung  5.9:  Knopfe  in  einer  Dialogbox 


Eine  weitere  Moglichkeit,  Mauswege  zu  optimieren,  sind  sogenannte  Pop-Up-Menus.  Sie 
erscheinen  an  der  Stelle,  an  der  mit  dem  Mauszeiger  geklickt  wird  (siehe  Abb.  5.10). 
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Rnrede : 

1 

Name : 

1 

1 

S trafle : 

1 

1 

Ort: 

1 

1 

; 

'L 

Abbildung  5.10:  Pop-Up-Menii  „Anrede“ 


Das  Menii  spring!  hoch  und  zeigt  eine  Menge  von  Alternativen,  aus  denen  nun  ausgewahlt 
warden  kann.  Pop-Up-Meniis  bieten  sich  vor  allem  an,  wenn  es  eine  begrenzte  Menge 
von  Alternativen  gibt,  wobei  es  eine  Starke  Uberforderung  des  Kurzzeitgedachtnisses  wa- 
re, alle  Alternativen  auf  einmal  zu  listen.  Entwickler  miissen  sich  keine  Sorge  urn  die 
Programmierung  von  Pop-Up-Meniis  machen,  da  die  dazu  notigen  Routinen  in  Kapitel 
6 vorgestellt  warden. 


Es  erhebt  sich  die  Frage,  wie  Pop-Up-Meniis  zu  bedienen  sind.  Beim  Apple  Macintosh 
ergibt  sich  kein  Problem,  da  dies  wie  bei  normalen  Meniis  geschieht:  Anklicken  und  bei 
gedriickten  Knopf  auswahlen,  dann  loslassen.  Bei  GEM  geschieht  ein  Auswahlen  von 
Meniis  ohne  gedriickten  Knopf.  Das  Aktivieren  des  Pop-Up-Meniis  muB  aber  durch 
Klicken  stattfinden.  Wie  geschieht  nun  die  weitere  Bedienung? 


Nach  dem  Aktivieren  durch  Klick  gibt  es  zwei  Moglichkeiten.  Bleibt  der  Mausknopf  ge- 
driickt,  so  kann  eine  Alternative  ausgewahlt  und  danach  der  Mausknopf  losgelassen  war- 
den (Macintosh-like).  Wird  der  Mausknopf  nach  dem  Aktivieren  sofort  wieder  losgelas- 
sen (Einfachklick  wie  zum  Selektieren  von  Objekten),  so  ist  der  Mauskopf  nun  oben,  und 
es  muB  auf  einen  erneuten  Klick  gewartet  warden  (GEM-like).  Die  Pop-Up-Meniis  sind 
nun  so  flexibel  implementiert,  daB  sich  der  Benutzer  heraussuchen  kann,  welche  Methode 
er  lieber  verwenden  mochte.  Dazu  muB  an  den  bestehenden  Routinen  nichts  ge^dert 
warden.  Je  nach  Aktivieren  des  Meniis  reagiert  dieses  entsprechend. 


5.2  Folgerungen 
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5.2.3  iibung 

Je  haufiger  ein  Anwender  ein  System  benutzt,  desto  mehr  Ubung  bekommt  er  im  Umgang 
mit  ihm.  Nach  einer  bestimmten  Zeit  weiB  er,  in  welchen  Mentis  sich  bestimmte  Kom- 
mandos  verbergen,  oder  wohin  er  zur  Beantwortung  eines  Dialogs  mit  der  Mans  fahren 
muB.  Hinter  diesem  Aspekt  steckt  das  Exponentialgesetz  der  Ubung  (s.o.). 

Dialogboxen  sollten  sich  immer  in  der  Mitte  des  Bildschirms  offnen,  damit  sie  einen  Platz 
einnehmen,  der  schwerlich  ubersehen  werden  kann.  Dasselbe  gilt  fur  Warn-  oder  Fehler- 
meldungen.  Um  einen  Dialog  zu  beenden  oder  einen  Fehler  zu  quittieren,  muB  ein  be- 
stimmtes  Kastchen  (Knopfe)  in  der  Dialogbox  angeklickt  werden.  Die  Kastchen  sollten 
sich  immer  am  unteren  Ende  der  Dialogbox  befinden,  so  daB  der  Anwender  mit  der  Mans 
schon  wahrend  des  Aufbaus  derselben  in  diese  Region  fahren  kann. 

Bei  manchen  GEM-Programmen  stehen  diese  Knopfe  alle  links  oder  rechts,  oben  oder 
sogar  in  der  Mitte  der  Dialogbox.  Wechselt  man  so  von  einem  Programm  zum  anderen, 
muB  der  Benutzer  sich  immer  wieder  umorientieren. 

Wir  legen  fest:  Es  sollte  sich  immer  eine  Mindestanzahl  von  Knopfen  in  einer  Dialogbox 
befinden.  Position,  Reihenfolge  und  Beschriftung  dieser  Standardknopfe  sollte  bei  alien 
Programmen  gleich  aussehen  (siehe  auch  Abb.  5.11). 


standardknopfe  einer  OialogboH 


OK 

HILFE 

RBBRUCH 

Abbildung  5.11:  Standard-Knopfe  in  einer  Dialogbox. 


Die  Knopfe  sollten  von  links  nach  rechts,  falls  dieser  Platz  nicht  ausreicht,  ausnahmswei- 
se  auch  von  oben  nach  unten  folgendermaBen  beschriftet  werden: 

OK:  Der  Dialog  wird  velassen.  Die  Einstellungen  werden  iibernommen  bzw.  ausgefiihrt. 

HILFE:  Der  Benutzer  bekommt  Information  iiber  die  Bedeutung  der  Dialogbox  und  wie 
sie  zu  handhaben  ist  (siehe  auch  5.3.).  Nach  Erscheinen  der  Hilfebox  befindet  man  sich 
wieder  im  Dialog. 

ABBRUCH:  Der  Dialog  wird  verlassen.  Die  Einstellungen  bzw.  Anderungen  werden 
nicht  ubemommen. 
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Bei  Dialogboxen,  die  nur  Information  anzeigen,  kann  auf  ABBRUCH  verzichtet  warden. 
Meistens  ist  dann  auch  HILFE  unnotig. 

Ein  weiteres  Kriterium,  sich  die  Ubung  des  Benutzers  zunutze  zu  machen,  sind  die  schon 
oben  erwahnten  Menus  mit  den  Tastaturkombinationen  wie  CUT,  COPY,  PASTE  (X-C- 
V).  Diese  drei  Tasten  liegen  nicht  zufallig  nebeneinander! 


5.2.4  Aufmerksamkeit 

Um  die  Aufmerksamkeit  des  Anwenders  auf  sich  zu  ziehen,  kann  das  Prinzip  der  varia- 
blen  Wahrnehmungsprozessor-Rate  herangezogen  werden.  Wie  aus  5.1.2  hervorgeht, 
miissen  Ereignisse,  die  als  getrennt  angesehen  werden  sollen,  in  einem  bestimmten  zeitli- 
chen  Abstand  voneinander  auftreten.  Dieser  Abstand  wird  durch  die  Zykluszeit  des  vi- 
suellen  Prozessors  bestimmt.  Durch  Anderung  der  Intensitat  des  Reizes  kann  die  Rate 
beeinfluBt  werden. 

Jeder  von  uns  kennt  wohl  schon  verschiedene  Arten,  wie  man  die  Aufmerksamkeit  des 
Benutzers  auf  sich  ziehen  kann.  Fur  das  akustische  System  kann  die  Benutzung  von  Ge- 
rauschen  angebracht  sein.  Bei  schwerwiegenden  Fehlem  kann  die  Fehlermeldung  durch 
ein  Gerausch,  wie  z.B.  einen  Pieps  begleitet  werden.  Dies  lenkt  die  Aufmerksamkeit  des 
Benutzers  auf  den  Bildschirm,  wenn  aus  seinem  Lautsprecher  das  Gerausch  ertont.  Der 
Pieps  sollte  aber  unbedingt  abschaltbar  sein,  da  durch  zu  viele  Gerausche  der  Benutzer 
verunsichert  wird.  In  einem  GroBraumburo  beispielsweise  wiirden  andere  Mitarbeiter  ge- 
stort  werden  oder  sie  wiirden  sich  iiber  den  Benutzer  des  Dialogsystems  lustig  machen 
(„Macht  der  heute  aber  einen  Haufen  Fehler...“). 

Fur  das  visuelle  Wahrnehmungsvermogen  vor  allem  beim  Auftreten  von  Fehlern  sorgt 
im  Prinzip  schon  die  Gestaltung  der  Alertboxen.  Sie  haben  jeweils  ein  groBes  Icon  am 
linken  Rand,  welches  beim  Erscheinen  des  Fehlers  oder  der  Warnung  ins  Auge  sticht. 

Eine  Moglichkeit,  Aufmerksamkeit  auf  das  Programm  zu  ziehen,  wird  auch  durch  Farbe 
erreicht.  Allerdings  sollten  nicht  zu  viele  Farbtone  verwendet  werden,  da  sonst  der  Reiz 
verlorengeht.  Gut  sind  Komplementarfarben,  also  Schwarz/WeiB,  Rot/Griin  oder 
Blau/Gelb. 


5.2.5  Vorhersehbarkeit,  Modi  und  Transparenz 

Eine  rationelle  Person  arbeitet  nach  dem  Prinzip  des  Problemraums  (siehe  5.1.3),  d.h. 
sie  andert  die  Zustande  ihres  Problemraums,  bis  sie  den  End-  oder  Zielzustand  erreicht 
hat.  Der  Anfangszustand  konnte  in  einem  Datenbanksystem  eine  leere  Datenbank  sein, 
der  Endzustand  eine  gefiillte  Datenbank  mit  Adressen  von  Kunden. 


5.2  Folgerungen 
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Das  Verhalten  des  Benutzers  kann  durch  das  Rationalitatsprinzip  erklart  werden.  Es 
scheint,  daB  der  typische  Anwender  eines  Programms  eine  Menge  Zeit  damit  verbringt, 
sich  zu  uberlegen,  was  er  als  nachstes  tun  soil.  Eines  der  Schliisselresultate  von  Card  und 
Moran  zeigen  jedoch,  daB  dies  nicht  der  Fall  ist. 

Der  trainierte  Benutzer  nimmt  mit  der  Zeit  eine  Menge  von  wiederholten,  einstudierten 
Verhaltensmustern  an,  von  denen  er  annimmt,  daB  durch  diese  die  Aufgabe  am  besten 
gelost  werden  kann.  (z.B.  zuriicktippen  bei  Fehlern  in  Textverarbeitung).  Dabei  ignoriert 
er  sogar  Funktionen  des  Programms,  die  er  nicht  in  seinem  Muster  aufgenommen  haben 
mochte. 

Hat  ein  Benutzer  beispielsweise  zwei  Buchstaben  in  einem  Wort  vertauscht,  so  mochte 
er  diese  wieder  in  die  richtige  Reihenfolge  bringen.  Es  gibt  Texteditoren  wie  den  von 
UNIX  bekannten  „vi“,  die  eine  solche  Funktion  bieten.  Arbeitet  man  mit  verschiedenen 
Editoren,  die  nicht  alle  die  gleiche  Funktionalitat  besitzen,  so  wird  man  sich  die  Funktion 
„Buchstaben  tauschen"  nicht  unbedingt  merken.  In  Texteditoren  ohne  diese  Funktion, 
wird  man  den  Cursor  an  die  entsprechende  Stelle  setzen,  einen  der  beiden  falschen  Buch- 
staben loschen,  den  Cursor  versetzen  und  den  nun  fehlenden  Buchstaben  wieder  einge- 
ben.  Diese  Vorgehensweise  wird  man  irgendwann  auch  bei  dem  Texteditor  benutzen,  der 
eigentlich  die  andere  Funktionalitat  bietet.  Das  erstaunliche  dabei  ist,  daB  man  mit  der 
„komplizierten  Methode"  meistens  auch  noch  schneller  ist,  da  man  dies  gewohnt  ist, 
wahrend  man  sonst  erst  einmal  uberlegen  muB,  wie  das  Kommando  „Buchstaben  tau- 
schen“  denn  nun  ausgefiihrt  wird. 

Um  nun  die  Verhaltensmuster  vorherzusagen,  wurde  das  GOMS-Modell  aufgestellt. 
GOMS  steht  fur  Goals-Operators-Methods-Selection.  Wahrend  des  Trainingsprozesses 
lernt  der  Benutzer,  die  Grundoperationen  so  zu  kombinieren,  daB  daraus  Methoden  zum 
Losen  seiner  Aufgabe  werden. 

Dabei  wurde  festgestellt,  daB  es  im  Prinzip  geniigt,  die  Anzahl  der  Tastaturanschlage, 
Mausbewegungen  und  Denkintervalle  aufzuaddieren,  die  fur  jede  Aufgabe  benotigt  wer- 
den. Dazu  kommt  die  Zeit  des  Rechners  zum  Antworten,  fur  die  Bewegung  der  Hand 
von  Tastatur  zur  Maus  usw.  Dies  wurde  auch  das  Keystroke-Level-Modell  genannt. 

Die  eigentliche  Aufgabe  der  Benutzerschnittstelle  liegt  nun  darin,  die  Anzahl  der  Aktio- 
nen,  die  zur  Losung  einer  Aufgabe  benotigt  werden,  mbglichst  gering  zu  halten  und  die 
einzelnen  Aktionen  mbglichst  schnell  auszufiihren.  Um  die  Denkzeit  des  Benutzers  gering 
zu  halten,  darf  die  (reine)  Kapazitat  des  Kurzzeitgedachtnisses  nicht  iiberlastet  werden, 
d.h.  zur  Erfiillung  einer  Aufgabe  sollten  3 bis  4,  besser  weniger  Schritte  genugen. 

Eine  gute  Methode,  das  Kurzzeitgedachtnis  zu  entlasten,  ist  die  Benutzung  von  Fenstern, 
wann  immer  dies  mbglich  ist.  In  Fenstern  ist  stets  Information  enthalten,  welche  parallel 
zu  anderen  Fenstern  standig  zuganglich  ist.  Der  Benutzer  muB  lediglich  das  Fenster  be- 
trachten,  es  eventuell  nach  vorne  holen,  und  schon  hat  er  die  gewiinschte  Information. 
Ein  gutes  Beispiel  sind  die  Sliders  (Schieber)  der  Fenster,  die  angeben,  wo  man  sich  in 
einem  Dokument  befindet  und  wieviel  man  von  ihm  im  Fenster  sehen  kann. 
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Der  wichtigste  Faktor  jedoch  ist  das  Erhohen  der  Vorhersehbarkeit  und  das  Erniedrigen 
der  Unentschlossenheit.  Das  Unsicherheitsprinzip  sagt  aus,  daB  die  Zeit  zum  Treffen 
einer  Auswahl  geringer  ist,  wenn  weniger  Alternativen  zur  Verfiigung  stehen.  Ein  System 
sollte  vor  allem  mit  dem  Benutzer  kommunizieren  und  aus  diesem  Feedback  entsprechen- 
de  Folgerungen  ziehen.  Dadurch  kann  der  Anfanger  die  Bedienung  des  Systems  leichter 
erlernen,  und  durch  die  Vorhersehbarkeit  wird  das  System  komfortabel  fur  den  trainier- 
ten  Benutzer. 

In  praxi  werden  nur  solche  Menupunkte  auswahlbar  gemacht,  die  vom  aktuellen  Status 
aus  durchgefiihrt  werden  konnen,  Ist  beispielsweise  noch  kein  Block  markiert,  so  kann 
er  z.B.  nicht  kopiert  oder  verschoben  werden  (siehe  Abb.  5.12).  Die  entsprechenden 
Menupunkte  sind  in  schwacher  Grauschrift  dargestellt. 


B I ock 


B I ockanf  ang 
Bl ockende 


hn«  f den 
e:  i n1  tiger! 


Eiletk  kepietar! 
Eltack  tmix  h iaSrari 


El!(i(k  Id^than 


ifltim  El  I (K  k<m1  <mg 
iiltim  Ellatkande 


k i ai  ting  Idsthari 


Abbildung.  S.12:  „Block“-Menupunkt  in  Wordplus 


Dagegen  ist  der  Meniipunkt  „Blockanfang“  anwahlbar.  Ist  ein  Blockanfang  angewahlt, 
so  kommt  jetzt  der  Meniipunkt  „Zum  Blockanfang"  hinzu  (Abb.  5.13). 
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Block 


Blockanfang 

Blockende 

hnoiden 
i:  infdg«n 


{INuk  k(ipt«i«n 
Block  i>o)xhi«h«ri 

Block  IcUchon 


Zum  Blockanfang 

Zum  BlockCM)clc{ 

M<irk  I c^roric)  IcKchcui 


Abbildung  5.13:  „Block“-Meniipunkt  mil  definiertem  Blockanfang 


Wenn  ein  Meniipunkt  ausgewahlt  wurde,  sollte  der  Meniititel  so  lange  invers  (weiB  auf 
schwarz)  bleiben,  bis  die  Operation  komplett  ausgefiihrt  wurde.  Dem  Benutzer  wird  so 
angezeigt,  daB  er  das  richtige  Menii  angew^lt  hat.  In  unserem  Beispielprogramm  wird 
z.B.  bei  der  Auswahl  des  Menus  Info  uber  eine  Funktionstaste  diese  invertiert  bleiben, 
bis  das  Menii  zu  Ende  gefiihrt  ist  (s.  Abb.  5.14).  Dasselbe  gilt  fur  das  Menii,  aus  dem 
die  Funktionstaste  entnommen  wurde.  Entsprechendes  gilt  auch  fur  die  anderen  Tasten- 
kombinationen,  die  zum  Ausfiihren  von  Meniipunkten  gedriickt  werden  miissen. 


SCRAP 


Date 


Bearbe i ten 


Opt i onen 


Abbildung  5.14;  Funktionstaste  und  Menu  aktiviert 
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Wird  in  unserem  Beispielprogramm  z.B.  der  Papierkorb  geoffnet,  so  erscheint  zunachst 
eine  VergroBerungsbox,  die  vom  angew^lten  Objekt  ausgeht  und  anzeigt,  daB  das  ent- 
sprechende  Objekt  geoffnet  wird.  Das  gibt  dem  Benutzer  wahrend  des  Ausfiihrens  der 
Operation  die  Sicherheit,  das  richtige  Objekt  benutzt  zu  haben.  Beim  SchlieBen  des  Fen- 
sters  wird  entprechend  die  Verkleinerungsbox  gezeichnet,  so  daB  nachtraglich  noch  fest- 
gestellt  werden  kann,  aus  welchem  Objekt  das  Fenster  geoffnet  wurde.  Das  Zeichnen  die- 
ser  Boxen  kostet  aber  eine  bestimmte  Zeit,  so  daB  es  giinstig  fur  den  trainierten  Benutzer 
ist,  wenn  er  diese  optische  Anzeige  ausschalten  kann.  Ein  Beispiel  hierfiir  ist  Tempus  2.0. 


Wahrend  der  Rechner  mit  einigen  Operationen  beschaftigt  ist,  zeigt  er  ein  Stundenglas 
(MS-DOS,  FlexOS)  Oder  eine  Biene  (ATARI  ST).  Bei  langer  dauernden  Operationen 
sollte  der  motnentane  Stand  der  Bearbeitung  standig  ausgegeben  werden,  so  daB  der  Be- 
nutzer die  Arbeit  des  Rechners  regelrecht  verfolgen  kann.  Beispiele  sind  die  Ausgabe  al- 
ler  Datensatze  auf  Drucker  oder  Diskette  im  Datenbanksystem  ADIMENS  ST  (Abb. 
5.15).  Dort  erfahrt  der  Anwender,  welche  Operation  gerade  lauft,  wie  sie  abgebrochen 
werden  kann,  wie  lange  sie  bereits  lauft  und  wie  lange  sie  noch  lauft.  Die  digitale  Anzeige 
in  Sekundenbruchteilen  muB  allerdings  erst  vom  Anwender  dekodiert  werden.  Schneller 
aufzufassen  ist  die  analoge  Anzeige,  die  hier  durch  einen  Balken  dargestellt  wird,  der 
nach  rechts  wandert.  Hier  erkennt  der  Anwender  sofort,  wie  weit  die  Operation  fortge- 
schritten  ist.  Die  Anzeige  ist  zwar  ungenauer  als  eine  digitale,  aber  meist  genugt  sie.  Der 
Anwender  darf  nie  im  Unklaren  gelassen  werden,  welche  Operation  gerade  lauft  und  wie 
weit  sie  fortgeschritten  ist! 


Eapor  t . ■ ■ 


esc)  bricht  ab 


Laufzei t : 

B8:B8: 18 

Restzei t ; 

88:81:33 

Mittel: 

88.32 

Datensatz:  _ 

__56 

e 
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Abbildung  5.15:  Anzeigebox  des  momentanen  Bearbeitungszustandes 


Wichtig  ist  auch,  die  Anzahl  der  Modi  so  gering  wie  moglich  zu  halten.  Ein  Modus  exi- 
stiert  genau  dann,  wenn  nicht  alle  Moglichkeiten  des  Programms  ausgenutzt  werden  kon- 
nen,  ohne  einen  Zwischenschritt  zu  tun.  Beispiele  sind  die  Programme,  welche  nur  Menu- 
technik  anwenden  (hierarchische  Systeme  wie  UCSD-Pascal).  Bei  diesen  muB  man  sich 
durch  einen  Dschungel  von  Menus  und  Untermeniis  durchhangeln,  bis  man  sich  an  der 
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gewiinschten  Stelle  befindet.  Durch  diese  Hierarchic  mufi  man  sich  dann  zuerst  wieder 
nach  oben  hangeln,  wenn  man  auf  einen  anderen  Zeig  wechseln  mochte. 

Beim  Losen  einer  Aufgabe  sieht  der  Benutzer  nun  fur  jeden  Modus  einen  zusatzlichen 
Zustand  in  seinem  Problemraum.  Diese  zusatzlichen  Zustande  miissen  analysiert  werden, 
was  Denkzeit  kostet.  Eine  Benutzerschnittstelle  ohne  Modi  nennt  man  auch  transparent, 
weil  die  Erfiillung  von  Aufgaben  nicht  an  bestimmte  Zustande  gekniipft  ist. 

Ein  Beispiel  ist  das  Ausdrucken  einer  Liste  aller  Datensatze  in  ADIMENS  ST.  In  man- 
chen  Programmen  muB  man  zuerst  ein  Menii  anwahlen,  um  das  Ausgabegerat  auf  den 
Drucker  umzustellen.  Danach  kehrt  man  zuriick,  um  in  einem  anderen  Menii  die  Daten- 
satze anzuwahlen  und  auszugeben.  In  ADIMENS  ST  wird  einfach  das  Symbol  des  Kartei- 
kastens  auf  das  Symbol  des  Druckers  gelegt.  Damit  beginnt  sofort  die  Ausgabe.  Sollen 
die  Datensatze  auf  Diskette  ausgegeben  werden,  kann  man  ebenfalls  ein  entsprechendes 
Symbol  (die  Diskstation)  benutzen. 

Das  Benutzen  von  Fenstern  ist  ebenfalls  eine  Methode,  Modi  zu  eliminieren.  Z.B.  ist  es 
im  Texteditor  TEMPUS  moglich,  Dateien  gleichzeitig  in  mehreren  Fenstern  zu  bearbei- 
ten,  ohne  daB  ein  Zustand  eingeschaltet  oder  verlassen  werden  muB.  In  herkommlichen, 
alteren  textorientierten  Systemen  kann  z.B.  immer  nur  eine  Datei  bearbeitet  werden. 
Ahnliches  gilt  fur  das  Programm  Signum.  Man  hat  immer  nur  die  Moglichkeit,  ein  Doku- 
ment  zu  einer  Zeit  zu  verarbeiten.  Mochte  man  eben  mal  in  einem  anderen  Dokument 
etwas  andern,  so  muB  man  das  aktuelle  Dokument  abspeichern,  das  neue  Dokument  la- 
den, die  Anderung  vornehmen,  das  Dokument  abspeichern,  das  alte  Dokument  laden  und 
schlieBlich  sogar  noch  die  Stelle  suchen,  an  der  man  sich  das  letzte  Mal  befunden  hat. 
Durch  diese  Vielzahl  von  Operationen  wird  das  Kurzzeitgedachtnis  erheblich  belastet, 
man  bekommt  ein  ungutes  Gefuhl. 

Ein  Modus  besteht  bei  GEM  immer,  wenn  eine  Dialogbox  oder  eine  Fehlermeldung  auf 
dem  Bildschirm  erscheint.  Bei  Fehlermeldungen  erscheint  dieser  Umstand  noch  tragbar, 
da  der  Benutzer  den  Fehler  zur  Kenntnis  nehmen  muB  und  das  System  eventuell  nach 
Auftreten  des  Fehlers  nicht  mehr  so  reagiert,  wie  der  Benutzer  dies  wollte  (z.B.  Fehler 
beim  Abspeichern,  da  die  Diskettenkapazitat  erschopft  ist). 

Bei  einer  Dialogbox  hingegen  muB  diese  erst  positiv  (OK)  oder  negativ  (ABBRUCH)  ver- 
lassen werden,  um  den  gewiinschten  Effekt  zu  erwirken.  Dies  bedeutet,  daB  in  der  Zeit, 
in  welcher  eine  Dialogbox  abgearbeitet  wird,  keine  andere  Aktion  stattfinden  kann.  Insbe- 
sondere  konnen  keine  Menus  angewahlt  werden.  Versuche  haben  gezeigt,  daB  Personen, 
die  sich  nicht  im  GEM  auskannten,  diesem  Umstand  keine  Rechnung  trugen  und  verzwei- 
felt  versuchten.  Mentis  anzuwahlen.  Tatsachlich  muB  es  fiir  einen  ungeubten  Benutzer 
merkwiirdig  sein,  auf  einmal  keine  Mentis  mehr  auswahlen  zu  diirfen. 

Aus  diesem  Dilemma  gibt  es  im  Prinzip  keinen  Ausweg,  da  der  Dialogmanager  des  GEM 
dies  genauso  vorgesehen  hat.  Beim  Macintosh  dagegen  hat  man  die  Moglichkeit,  soge- 
nannte  „modeless  dialog  boxes'*  zu  programmieren.  Eine  solche  Dialogbox  befindet  sich 
in  einem  Fenster.  Dadurch  konnen  weiterhin  Mentis  und  andere  Boxen  geoffnet  werden. 
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ohne  dafi  die  aktuelle  Dialogbox  verlassen  wird.  Es  gibt  naturlich  auch  die  Moglichkeit, 
solche  Boxen  in  GEM  zu  programmieren.  Nur  hat  man  hier  einen  erheblich  groBeren 
Aufwand.  Wir  haben  diese  Moglichkeit  zunachst  noch  offen  gelassen,  jedoch  schon  vor- 
gesehen.  Moglicherweise  wird  in  einer  der  nachsten  Auflagen  ein  Dialogmanager  ohne 
Modus  in  das  Beispielprogramm  eingebunden  sein. 

Wichtig  ist  dies  auch  fur  die  gleichzeitige  Verwendung  mehrerer  Programme,  wie  dies 
zum  Beispiel  bei  X/GEM  der  Fall  ist.  Die  Verwendung  von  Dialogboxen  ist  dort  tatsach- 
lich  ein  Problem,  well  innerhalb  der  Box  nicht  auf  eine  andere  Applikation  umgeschaltet 
werden  kann.  Das  Umschalten  geschieht  bekanntlich  durch  Anklicken  eines  zur  Anwen- 
dung  gehorenden  Fensters  oder  durch  Auswahlen  der  Applikation  aus  dem  aktiven  Menii 
des  obersten  Fensters.  Benutzung  von  Dialogboxen  ohne  Modi  unterstutzt  somit  die 
Multi-Tasking-Eigenschaften  eines  Systems. 

Eine  andere  Definition  besagt,  daft  Programme  transparent  sind,  wenn  jede  Aktion  genau 
ein  Resultat  zur  Folge  hat.  Dieser  Umstand  sollte  moglichst  immer  beachtet  werden.  In 
Dialogboxen  wird  dies  automatisch  durch  den  Dialogmanager  des  GEM  eingehalten. 
Ahnliches  gilt  fiir  Fenster.  Es  hat  allerdings  Programme  wie  eine  friihere  Version  des 
SPC-Modula  gegeben,  bei  denen  die  Bedeutung  der  SchlieBbox  und  der  VergroBerungs- 
box  vertauscht  waren!  Der  Benutzer  kann  das  Resultat  in  diesem  Fall  nicht  mehr  vorher- 
sehen.  Ahnliches  gilt  fur  die  Programme  Signum  und  STAD.  Beide  benutzen  die  linke 
und  rechte  Maustaste.  Mochte  man  bei  Signum  um  eine  Seite  vorwartsblattern,  benutzt 
man  die  rechte  Maustaste,  beim  Riickwartsblattern  die  linke.  Bei  STAD  ist  es  genau  um- 
gekehrt!  Mochte  man  die  nachste  Bildschirmseite  sehen,  so  klickt  man  mit  der  linken  Ta- 
ste in  das  entsprechende  Feld,  fiir  die  vorige  Seite  benotigt  man  die  rechte  Taste. 

Die  Resultate,  die  von  Aktionen  erzeugt  werden,  sollten  bei  moglichst  alien  Programmen, 
die  auf  einem  Rechner  laufen,  die  gleichen  sein.  Bei  Rechnern  wie  dem  Macintosh  wird 
dies  hervorragend  eingehalten,  so  daB  ein  Anwender,  der  ein  Programm  bereits  bedienen 
kann,  sich  sehr  schnell  in  anderen  Programmen  zurechtfindet. 

Das  einzige  GEM-Programm,  das  jeder  nach  kurzer  Zeit  bedienen  kann,  ist  der  GEM- 
Desktop,  da  er  beim  Einschalten  des  Rechners  als  erste  Applikation  zur  Verfiigung  steht 
und  standig  benutzt  wird.  Programme,  die  sich  so  verhalten  wie  der  GEM-Desktop,  wird 
jeder  ATARI  ST-Benutzer  schnell  bedienen  konnen. 

Bei  ADIMENS  ST  Oder  dem  Textdeditor  TEMPUS  wurde  auf  eben  genannte  Tatsache 
groBen  Wert  gelegt.  In  TEMPUS  wird  z.B.  der  Text  geloscht,  wenn  das  entsprechende 
Piktogramm  auf  den  Papierkorb  gelegt  wird. 

In  ADIMENS  ST  kann  das  Loschen  eines  Datensatzes  genauso  geschehen  wie  das  L6- 
schen  einer  Datei  auf  dem  GEM-Desktop,  d.h.  ein  Fenster  offnen,  um  den  Inhalt  anzuzei- 
gen  und  dann  den  entsprechenden  Datensatz  oder  die  ganze  Datei  in  den  Papierkorb 
legen. 

Auch  das  Selektieren  von  mehreren  Objekten  in  einem  Bildschirmfenster  sollte  immer 
in  gleicher  Weise  vonstatten  gehen.  Eine  Moglichkeit  ist  das  Einrahmen  (dragging)  von 
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Objekten  mil  Hilfe  des  Gummibandes  (dragbox).  Alle  Objekte,  die  das  Gummiband 
schneiden,  werden  selektiert.  Eine  andere  Moglichkeit  ist  die  Auswahl  mit  Hilfe  der 
Shift-Taste  und  dem  MauskJick.  Damit  konnen  Objekte,  die  nicht  zusammenstehen,  aus- 
gewiihlt  werden. 

Eine  neue  Methode,  mehrere  Zeilen  in  einem  Texteditor  auszuwahlen,  ist  das  Benutzen 
eines  unsichtbaren  Gummibandes,  wobei  wahrend  des  Aufziehens  alle  Zeilen,  die  iiber- 
strichen  werden,  selektiert  werden  (siehe  Abb.  5.16).  Dies  wird  beispielsweise  im  Editor 
des  Turbo-C-Entwicklungspakets  benutzt.  Der  groBte  Vorteil  dieser  Methode  ist  es,  dafi 
der  Benutzer  die  Moglichkeit  hat,  die  Reaktion  auf  seine  Aktion  in  Echtzeit  zu  verfolgen 
und  Fehler  sofort  korrigieren  zu  konnen,  noch  bevor  die  Aktion  abgeschlossen  ist.  Im 
Prinzip  wird  hier  ein  weiterer  Modus  abgeschafft,  da  das  Resultat  nach  Loslassen  der 
Maustaste  sofort  so  zur  Verfiigung  steht,  wie  es  angezeigt  wurde  (What  you  see  is  what 
you  get). 


us_cllp  (udi_handle,  clipflag,  pay);  /*  Seize  Rechteckausschni tt  */ 
} /*  set-c I ip  */ 

#if  GEM  & (GEM2  I GEM3  I HGEM) 


LOCRL  IPORO  graf ..grauiboH  (orga,  orgy,  orgiif,  orgh,  a,  y,  up,  h) 
diORD  orga,  orgy,  orgiv,  orgh; 

IliQRR  a,  y,  UP,  h; 


moRD  CH,  cy,  cnt,  astep,  ystep; 

agrf -stepcalc  (orgui,  orgh,  a,  y,  up,  h,  D-ca,  &cy,  Ocnt,  (Vastep,  Gyste 
graf-mboa  (orgup,  orgh,  orga,  orgy,  ca,  cy) ; 
agrf-2boa 


IcK,  cy, 
return  (D? 

} /*  graf-groupboa  •/ 


orgup,  orgh,  TRUE,  cnt,  astep,  ystep,  TRUE); 


Abbildung  5.16:  Selektieren  von  mehreren  Zeilen  in  Echtzeit 


Eine  bekannte  Methode  beim  Ziehen  von  Objekten  ist  auch  das  automatische  Invertieren 
der  iiberstrichenen  Objekte.  Beim  GEM-Desktop  ist  dies  bekannt,  wenn  z.B.  eine  Datei 
geloscht  Oder  kopiert  werden  soil.  Noch  wahrend  des  Ziehens  wird  das  iiberstrichene  Ob- 
jekt  invertiert,  urn  anzuzeigen,  dal3  beim  Loslassen  des  Mausknopfes  diese  Aktion  ausge- 
fiihrt  wird.  Leider  gibt  es  dafiir  keine  Routine  in  GEM,  die  dies  automatisch  erledigt. 
In  unserem  Beispielprogramm  ist  allerdings  eine  solche  Routine  enthalten.  Sie  ist  allge- 
mein  geschrieben  und  kann  fur  beliebige  Objekte  benutzt  werden  (siehe  auch  Abb.  5.17). 
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SCRAP  Datei  Bearbeiten  Optionen 


Abbildung  5.17:  Ziehen  von  Objekten  mit  Invertieren  des  Ziels 


5.2.6  Ubersichtlichkeit  von  Dialogboxen 


Um  Dialogboxen  iibersichtlich  zu  gestalten,  hat  man  eine  Menge  von  Moglichkeiten. 
Wichtig  sind  folgende  Grundprinzipien: 


— Nicht  zu  viele  Objekte  auf  einer  Ebene  verwenden. 

— Klare  Abgrenzung  zwischen  Anzeigen  und  aktivierbaren  Schaltern 

— Gleicher  Aufbau  aller  Dialogboxen  einer  Applikation 

— Moglichst  gleicher  Aufbau  der  Dialogboxen  aller  Applikationen 

— Benutzung  der  gleichen  Buttons  mit  gleicher  Wirkung 

— Untergliederung  der  Information  in  Blocke 

— Jede  Dialogbox  sollte  eine  abgeschlossene  Teilaufgabe  behandeln 

— Uberfliissige  Informationen  weglassen 

— Numerische  Daten  digital  anzeigen,  wenn  genaues  Ablesen  erforderlich 

— Numerische  Daten  analog  anzeigen,  wenn  Schatzen  angebracht  ist 

— Eventuell  Daten  sowohl  digital  als  auch  analog  anzeigen 

— Blinken,  Inversdarstellung  und  Farben  sparsam  beniitzen 


Um  einige  der  oben  angesprochenen  Punkte  zu  veranschaulichen,  betrachten  wir  die  fol- 
gende Dialogbox  „Druckereinstellung“  zur  Steuerung  einer  Druckausgabe  (Abb.  5.18). 


5.2  Folgerungen 
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OftUCKKR 


Druckereinstel lungen 


Steuerzeichen: 
Rusgabedatel : 


p Schrirtart  -| 

- Rusgabegerat  - 

p Zei  lenabstand  -< 

O Pica 

® Elite 
O Schmal 
^ Klein 

O PRN: 
O HUH: 

® 1/6" 

O 1/8“ 

O 12/72-“ 

□ Breit 

® Datei 

□ Kursiu 

O Spool 

1 LRDEN 

H Fett 

^ NLQ 

1 SPEICHERN 

1 OK 

HILFE 

RBBRUCH 

Abbildung  5.18:  Beispielhafte  Dialogbox 


Die  oben  dargestellte  Dialogbox  erfullt  die  oben  angegebenen  Forderungen  in  folgender 
Weise: 

Von  oben  nach  unten  betrachtet  gibt  es  zunachst  einmal  den  Titel  der  Dialogbox,  der  an- 
zeigt,  wo  man  sich  iiberhaupt  befindet.  Links  daneben  befindet  sich  das  Icon,  welches 
angeklickt  wurde,  bevor  sich  die  Dialogbox  offnete.  Das  Symbol  des  Druckers  ist  schnel- 
ler  vom  visuellen  System  zu  verarbeiten  als  die  Uberschrift. 

Nach  zwei  editierbaren  Zeilen,  von  denen  die  zweite  nur  dann  zu  editieren  ist,  wenn  das 
Ausgabegerat  auf  Datei  umgestellt  ist,  folgen  drei  Blocke  von  Informationen.  Die  Block- 
bildung  wind  hier  auf  dieselbe  Weise  vorgenommen,  wie  dies  in  Macintosh-Programmen 
iiblich  ist.  Es  gibt  einen  Rahmen,  der  einen  Block  begrenzt.  Dieser  hat  eine  Uberschrift, 
die  sich  am  oberen  Blockrand  befindet,  aber  noch  zu  diesem  gehort. 

Diese  Art  der  Uberschrift  ist  in  GEM  nicht  ohne  einen  kleinen  Trick  moglich,  da  bei  ver- 
schiedenen  Aufldsungen  die  halbe  Schrifthdhe  nicht  immer  eine  feste  Anzahl  von  Pixeln 
betragt.  Eine  solche  Blockiiberschrift  kann  in  einem  Resource-Construction-Set  durch 
Hilfe  des  erweiterten  Typs  (siehe  auch  Kapitel  2)  definiert  werden.  In  dem  Modul  „Re- 
source“  unseres  Beispielprogramms  wird  die  Uberschrift  automatisch  richtig  plaziert. 

In  einem  solchen  Block  befmden  sich  die  Einstellungen,  wobei  unterschieden  werden  muB 
zwischen  normalen  Knopfen  und  Radio- Knopfen.  Bei  Radio-Knopfen  kann  immer  nurge- 
nau  eine  Alternative  aktiv  sein.  Beim  Aktivieren  einer  Alternative  erlischt  entsprechend 
eine  andere  Alternative.  Normale  ankreuzbare  Knopfe  konnen  ein-  und  ausgeschaltet 
werden. 
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GEM  selbst  macht  nun  keinen  Unterschied  zwischen  anw^lbaren  Knopfen,  Radio- 
Knopfen  und  Aktions-Knopfen,  die  auch  eine  Aktion  wie  z.B.  das  Verlassen  des  Dialogs 
verursachen.  Der  Macintosh,  aber  auch  Microsoft  Windows  erlauben  es,  durch  einen  ein- 
zigen  Blick  zu  erkennen,  urn  welche  Art  von  Knopfen  es  sich  handelt; 

Anwahlbare  Knopfe  sind  quadratisch  und  konnen  angekreuzt  werden.  Radio-Kopfe  sind 
rund  und  konnen  ebenfalls  aktiviert  werden.  Die  Bedeutung  der  Knopfe  befindet  sich  im- 
mer  rechts  neben  den  Knopfen.  Aktions-Knopfe  sind  groBer,  da  sie  die  Aktion  selbst  be- 
herbergen. 

Wie  man  am  obigen  Beispiel  leicht  sehen  kann,  haben  auch  wir  diese  Techniken  bevor- 
zugt.  Der  Vorteil  liegt  auf  der  Hand.  Mit  einem  Blick  erkennt  man,  um  welche  Art  von 
Knopf  es  sich  handelt.  Die  fehlenden  ankreuzbaren  Knopfe  und  runden  Radio-Knopfe  ha- 
ben wir  so  allgemein  implementiert,  daB  man  jede  Dialogbox  damit  ausstatten  kann.  Es 
handelt  sich  um  benutzerdefmierte  Objekte,  die  man  wie  die  Blockiiberschriften  durch 
einen  erweiterten  Typ  definieren  kann.  Auch  diese  werden  von  dem  Modul  „Resource“ 
unseres  Beispielprogramms  verarbeitet.  Der  Software-Entwickler  kann  sie  wie  normale 
Buttons  behandeln.  Damit  kommt  man  dem  Macintosh-Standard  bei  Dialogboxen  schon 
sehr  nahe. 

Die  Aktions-Knopfe  in  dieser  Dialogbox  lauten  OK,  HILFE  und  ABBRUCH.  Es  sind 
Standard-Knopfe,  die  immer  angeboten  werden  sollten.  Sie  bewirken  eine  bestimmte 
Ebene  von  Konsistenz  innerhalb  eines  Programms  aber  auch  zwischen  den  Programmen. 
OK  bewirkt  ein  Verlassen  der  Dialogbox,  wobei  die  Einstellungen  iibernommen  werden. 
Entsprechendes  gilt  fiir  ABBRUCH,  wobei  die  Einstellungen  aber  nicht  iibernommen 
werden  sollen.  Bei  Betatigen  des  HILFE-Knopfes  wird  die  Dialogbox  kurzzeitig  verlas- 
sen. Es  erscheint  eine  Hilfe-Tafel,  die  dem  Benutzer  zeigt,  wie  er  die  Dialogbox  zu  ver- 
stehen  hat.  Das  Thema  Hilfe  wird  im  nachsten  Abschnitt  noch  einmal  ausfiihrlicher  aufge- 
griffen. 

Wir  haben  bereits  oben  gesehen,  wie  man  mit  Hilfe  von  Pop-Up-Meniis  die  Mauswege 
optimieren  kann.  Pop-Up-Meniis  haben  aber  noch  eine  andere  Bedeutung.  Sie  konnen 
auch  in  Dialogboxen  giinstig  eingesetzt  werden,  um  etwa  Information  zu  verstecken,  die 
dann  auf  Mausklick  angezeigt  wird.  Der  tiefere  Sinn  liegt  wieder  in  der  begrenzten  Kapa- 
zitat  des  Kurzzeitgedachtnisses.  Bei  zu  vielen  Informationen  gleichzeitig  wird  dieses  total 
iiberlastet. 

Die  Abbildung  5.10  (siehe  oben)  zeigt  eine  einfache  Dialogbox,  bei  der  die  Eingabe  des 
Feldes  „Anrede“  einer  Karteikarte  iiber  ein  Pop-Up-Menii  geregelt  wird. 

Um  nun  zu  erkennen,  welche  Felder  versteckte  Informationen  beinhalten,  sollten  wegen 
der  Vorhersehbarkeit,  die  dem  Benutzer  geboten  werden  sollte,  ein  eindeutiges  und  ein- 
heitliches  Aussehen  erreicht  werden.  Seit  dem  Friihjahr  1988  sind  Pop-Up-Menus  im 
Macintosh-Betriebssystem  implementiert.  Wir  schlagen  vor,  das  Aussehen  an  das  vom 
Macintosh  anzugleichen.  Das  bedeutet,  daB  Pop-Up-Meniis  in  Dialogboxen  einfache 
Rahmen  mit  Schatten  haben.  Entsprechend  sollten  die  Felder,  die  Pop-Up-Meniis  beher- 
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bergen,  eingerahmt  sein  und  ebenfalls  einen  Schatten  zeigen.  Sie  sehen  durch  diese 
pseudo-dreidimensionale  Darstellung  aus,  als  konnten  sie  noch  Information  in  der  dritten 
Dimension  (der  Hohe)  verbergen. 

Die  Benutzung  eines  Pop-Up-Meniis  wurde  schon  weiter  oben  erlautert. 

Ein  letztes  Wort  zu  den  Dialogboxen.  Viele  Entwickler  erweitern  wahrend  der  Program- 
mierung  den  Inhalt  der  Dialogboxen.  Doch  viele  Entwickler  konnen  sich  nicht  durchrin- 
gen,  die  Dialogbox  danach  zu  sortieren.  Die  meisten  Menschen  lesen  von  oben  nach  unten 
bzw.  von  links  nach  rechts.  Genauso  sollten  auch  die  Inhalte  von  Dialogboxen  sortiert 
sein.  Beim  Aufbau  der  Box  ergibt  sich  dann  ein  gleichmaBiges  Bild. 

Werden  sie  nicht  sortiert,  so  erscheinen  die  einzelnen  Elemente  wild  durcheinander,  un- 
ten, oben,  rechts,  dann  wieder  in  der  Mitte  usw.  Dies  verwirrt  den  Benutzer,  da  er  seine 
Aufmerksamkeit  auf  die  Reihenfolge  des  Aufbaus  legt.  AuBerdem  kann  er  nicht  von  oben 
nach  unten  lesen,  wahrend  die  Box  sich  schon  aufbaut,  da  am  Ende  noch  Information 
zuganglich  gemacht  werden  konnte,  die  zuerst  fehlt.  Beispiele  solcher  unsortierter  Dia- 
logboxen fmdet  man  in  Programmen  wie  Signum  oder  Turbo  C. 

Das  gleiche  gilt  iibrigens  auch  fur  Mentis.  Sie  sollten  sich  immer  von  oben  nach  unten 
aufbauen.  Bestimmte  Resource-Construction-Sets  ubernehmen  gliicklicherweise  die  Sor- 
tierung  automatisch,  so  daB  man  sich  nicht  selbst  darum  kummern  muB. 


5.3  Fehlerbehandlung 

Ein  wichtiges  Kapitel  beim  Aufbau  von  Benutzeroberflachen  ist  die  Fehlerbehandlung 
und  die  Hilfestellung  des  Programms.  Bei  der  Fehlerbehandlung  unterscheidet  man  Feh- 
lervermeidung  und  Fehleraufhebung. 

Bei  der  Fehlervermeidung  wird  vom  System  darauf  geachtet,  daB  der  Benutzer  keinen 
Fehler  machen  kann.  Dazu  gehoren  z.B.  die  abgeschalteten  (grauen)  Meniipunkte,  die 
ein  Benutzer  nicht  anwahlen  kann,  wenn  nicht  ein  bestimmter  Zustand  vorliegt.  Durch 
das  Verhindern  der  Meniiauswahl  kann  der  Benutzer  in  diesem  Sinne  zumindest  kein  Me- 
nu anwahlen,  welches,  ware  es  anwahlbar,  einen  Fehler  erzeugen  wiirde. 

Ahnliches  gilt  fur  die  Optionen  einer  Dialogbox,  welche  grau  dargestellt  sind,  wenn  sie 
nicht  angewahlt  werden  konnen. 

Ein  optimales  System  ware  eines,  bei  dem  nie  ein  Fehler  auftreten  kann.  Dies  ist  jedoch 
praktisch  nicht  zu  verwirklichen  — zumindest  nicht  softwaremaBig.  So  kann  man  beim 
Atari  oder  beim  IBM  PC  jederzeit  die  Diskette  im  Laufwerk  wechseln,  auch  wahrend 
Schreiboperationen  durchgefiihrt  werden.  Beim  Macintosh  ist  dies  z.B.  nicht  moglich, 
hier  kontrolliert  die  Software  den  Diskettenauswurf.  Fehler  durch  Unachtsamkeit  beim 
Diskettenwechsel  konnen  erst  gar  nicht  auftreten. 
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Fehleraufhebung  bedeutet  ein  Ruckgangigmachen  einer  Operation.  Man  nennt  dies  auch 
eine  „Undo“-Funktion.  Optimal  ware  die  Realisierung  eines  Systems,  bei  dem  man  zu 
jedem  Zeitpunkt  jede  friihere  Situation  wieder  herstellen  kann,  d.h.  ein  Ruckgangig- 
machen von  beliebig  vielen  Schritten.  Dies  ist  jedoch  ohne  enormen  Aufwand  nicht  so 
einfach  moglich.  Beispiele  sind  Datenbanken  mit  Transaktionsmechanismen  oder  das 
SCCS-System  unter  UNIX,  bei  dem  nur  die  Differenzen  von  Quelltexten  gespeichert  wer- 
den.  Man  kann  dann  jederzeit  bestimmen,  welche  (zeitliche)  Version  eines  Quelltextes 
man  zur  Verfugung  haben  mochte.  Dazu  gehort  allerdings  eine  gewisse  Disziplin  beim 
Schreiben  der  Quelltexte. 

Viele  Programme,  vor  allem  Texteditoren  bieten  inzwischen  Undo-Funktionen,  um  die 
letzte  Aktion  riickgangig  zu  machen.  Dies  gilt  jedoch  nicht  fur  alle  Operationen.  Ein  glo- 
bales  Suchen  und  Ersetzen  kann  nur  von  den  wenigsten  Texteditoren  wieder  riickgangig 
gemacht  werden.  Bei  den  meisten  Grafikprogrammen  (z.B.  STAD)  gibt  es  ebenfalls 
U ndo-Moglichkeiten . 

Der  GEM-Desktop  ist  auch  nicht  gerade  ein  Paradebeispiel  fiir  Undo-Funktionalitat.  Eine 
geloschte  Datei  ist  unwiderruflich  verloren.  Besser  hat  man  es  auf  DOS-Rechnern,  wo 
man  geloschte  Dateien  einigermalien  bequem  mit  Hilfe  von  Utilities  zuriickholen  kann. 
Die  beste  Losung  allerdings  bietet  der  Finder  des  Macintosh,  bei  dem  man  geloschte  Da- 
teien einfach  wieder  aus  dem  Papierkorb  zieht. 

Eine  Undo-Funktion  fur  Dialogboxen  bietet  immerhin  der  ABBRUCH-Knopf.  Bei  Fen- 
stern  konnen  auch  bestimmte  Funktionen  leicht  riickgangig  gemacht  werden.  Ein  Scrol- 
ling nach  unten  kann  durch  ein  Scrolling  nach  oben  leicht  durch  den  Benutzer  kompensiert 
werden.  Beim  SchlieUen  eines  Fensters  sollte  darauf  geachtet  werden,  daft,  wenn  sich  das 
Fenster  in  ein  Icon  „verwandeln“  kann,  durch  ein  erneutes  Offnen  des  Icons  das  Fenster 
sich  wieder  an  der  alten  Position  befindet.  Hervorragend  gelost  ist  dies  z.B.  beim  Textedi- 
tor  TEMPUS. 

Das  Undo  bietet  dem  Benutzer  die  notige  Sicherheit,  mit  dem  System  zunachst  zu  experi- 
mentieren,  ohne  daB  er  Sorgen  haben  miiBte,  daB  seine  Arbeitsergebnisse  durch  unsach- 
gemaBe  Bedienung  verloren  sind.  Wir  konnen  hier  nicht  genug  darauf  hinweisen,  daB 
moglichst  Jedes  Programm  eine  Undo-Funktion  haben  sollte.  Als  Bedienung  bietet  sich 
die  Undo-Taste  an.  Da  diese  Jedoch  beim  IBM  PC  nicht  existiert,  sollte  man  hier  auf  eine 
Funktionstaste  oder  eine  Control-Kombination  ausweichen.  Control-Z  hat  sich  hier  be- 
reits  als  Standard  durchgesetzt. 


5.4  Hilfe 

Ein  ausgeklugeltes  Hilfesystem  ist  enorm  wichtig.  Es  entlastet  das  Langzeitgedachtnis 
und  bietet  zu  jedem  Zeitpunkt  eine  angemessene  Hilfe.  Ein  gutes  Hilfesystem  bietet  das 
Entwicklungspaket  von  Turbo-C.  Zu  jedem  Zeitpunkt  kann  ein  Stichwortverzeichnis  auf- 
gerufen  werden,  wobei  die  Stichworte  selbst  fett  gedruckt  sind.  Bei  Anklicken  eines 
Stichwortes  verzweigt  das  Programm  zum  entsprechenden  Kapitel.  Doit  befinden  sich 
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meist  Querverweise,  die  wiederum  fett  gedruckt  sind  und  als  Einstiegspunkt  in  ein  ande- 
res  Kapitel  dienen.  Auf  diese  Weise  spart  man  sich  das  standige  Suchen  im  Handbuch. 

Fiir  Programmierer  ist  ein  solches  System  ideal,  da  es  eine  groBe  Menge  von  Funktionen 
gibt,  deren  Parameter  er  sich  nicht  immer  merken  kann.  Fin  Anwender  hat  aber  andere 
Vorstellungen  von  einer  Hilfestellung.  Fr  mochte  zu  jedem  Zeitpunkt  eine  Hilfestellung 
aufrufen  kdnnen,  die  sich  auf  die  aktuelle  Situation  bezieht.  Dies  nennt  man  auch  eine 
kontextsensitive  Hilfe. 

Bereits  1982  hat  Nievergelt  die  vier  wichtigen  Fragen  formuliert,  auf  die  ein  Dialog- 
system  jederzeit  dem  Benutzer  Auskunft  geben  muB: 


— Wo  bin  ich? 

— Was  kann  ich  hier  tun? 

— Wie  kam  ich  hierhin? 

— Wo  kann  ich  hin,  und  wie  komme  ich  dorthin? 

In  eine  Applikation  sollte  nun  eine  Hilfestellung  derart  eingebaut  werden,  daB  bei  Betati- 
gen  des  Meniipunktes  „Hilfe“  oder  Driicken  der  Taste  „Help“  bzw.  Anwahlen  des  Knop- 
fes  „Hilfe“  die  oben  erwahnte  Hilfestellung  erscheint.  Die  Hilfemeldungen  sollten  dann 
kontextabhangig  gegeben  werden.  Das  bedeutet  im  einzelnen; 

a)  In  jeder  Dialogbox  muB  sich  ein  Hilfe-Knopf  befmden,  bei  dessen  Betatigung  eine  Hil- 
femeldung  iiber  gerade  diese  Dialogbox  ausgegeben  wird. 

b)  In  jeder  Fehlermeldung  muB  sich  ein  Hilfe-Knopf  befmden,  bei  dessen  Betatigung  eine 
entsprechende  Hilfemeldung  iiber  diesen  Fehler  ausgegeben  wird.  Fs  muB  dem  Benutzer 
klargemacht  werden,  warum  der  Fehler  aufgetreten  ist  und  wie  er  zu  beheben  ist. 

c)  Ist  ein  Fenster  offen  und  keine  Dialogbox  oder  Fehlermeldung  auf  dem  Bildschirm, 
so  muB  zu  diesem  Fenster  eine  entsprechende  Hilfemeldung  ausgegeben  werden. 

d)  Ist  kein  Fenster  und  keine  Dialogbox  offen  (der  normale  Desktop  ist  dann  sichtbar), 
so  kann  ein  genereller  Hilfstext,  welcher  sich  auf  das  Programm  selbst  bezieht,  ausgege- 
ben werden. 

Bei  Betatigen  des  Hilfe-Knopfes  in  Dialog-  und  Alertboxen  erscheint  die  Hilfemeldung 
mit  folgenden  Informationen: 


— Wo  bin  ich? 

In  einer  Dialogbox  sollte  am  oberen  Rand  immer  der  Titel  dieser  Box  stehen.  Dieser  sollte 
irgendwie  hervorgehoben  werden  (invertiert,  schattiert  etc.)  und  fur  alle  Dialogboxen  der 
Applikation  gleich  aussehen.  Diese  Regel  gilt  auch  fur  Hilfe-Dialogboxen. 
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— Was  kann  ich  hier  tun? 

Fiir  jeden  Knopf,  der  anwahlbar  ist  oder  eine  Aktion  auslost,  sollte  eine  Erklarung  in  der 
Hilfe-Dialogbox  gegeben  warden. 

— Wie  kam  ich  hierhin? 

Die  Antwort  sollte  dem  Benutzer  aufzeigen,  welchen  Weg  er  eingeschlagen,  beziehungs- 
weise  welche  Aktionen  er  bis  dahin  ausgeldst  hatte.  Dies  gilt  besonders  fiir  Hilfe  bei 
Fehlermeldungen. 

— Wo  kann  ich  hin,  und  wie  komme  ich  dorthin? 

Bei  den  Standard-Dialogboxen,  ist  die  Antwort  schon  vorgegeben.  Der  OK-Knopf  be- 
wirkt  ja  das  positive,  der  Abbruch-Knopf  das  negative  Verlassen  der  Box.  Der  Hilfe- 
Knopf  zeigt  den  Hilfetext  an.  Existieren  weitere  Knopfe,  die  eine  weitere  Dialogbox  off- 
nen,  wie  zum  Beispiel  das  Laden  einer  Einstellung,  so  muB  dies  erklart  werden. 

Fiir  die  Moglichkeit,  Hilfetexte  auch  aus  Alertboxen  heraus  auszugeben,  wurde  eine  Rou- 
tine implementiert,  der  die  Fehlermeldung  und  ein  Objektbaum  fiir  den  Hilfetext  mitgege- 
ben  wird.  Wird  nun  in  der  Fehlermeldung  der  Hilfe-Knopf  gedriickt,  so  wird  dieser  Ob- 
jektbaum auf  dem  Bildschirm  ausgegeben.  Der  Hintergrund  wird  wie  bei  einer  Alertbox 
gerettet,  so  daB  der  urspriingliche  Kontext  nach  Verlassen  der  Hilfsbox  nicht  verloren- 
geht.  Abbildung  5.19  zeigt  eine  Fehlermeldung,  Abbildung  5.20  die  aus  dem  Anwahlen 
des  Hilfekopfes  resultierende  Dialogbox. 


Funkt  ionsausfuhrung  fiir 
Benutzer  nicht  erlaubt! 


I Hurt  ^ I RBBRUCH~| 


Abbildung  5.19:  Beispiel-Fehlermeldung 
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1 HILFE  1 

1 

$le  haben  gerade  uersucht,  eine  Date!  in  den  Papierkorb 
zu  uierfen. 


Fur  diese  Rktian  haben  Sie  momentan  keine  Berecht i gung . 

Urn  diese  Berecht igung  zu  eriangen,  mussen  Sie  den  Super- 
User  ueraniassen,  ihnen  diese  zu  erstatten. 

Sie  haben  nur  die  Mbgiichkeit,  die  Bktion  durch  Drucken 
uon  ’ABBRUCH*  abzubrechen. 

I OK  I 


Abbildung  5.20:  Hilfe-Dialogbox  zu  obiger  Fehlermeldung 


Am  besten  ware  natiirlich  ein  Hilfesystem  in  einem  echten  Fenster,  welches  man  parallel 
zum  eigentlichen  Arbeitsgang  geoffnet  haben  kann.  Konsequenterweise  miiBte  man  bei 
einem  solchen  System  aber  auf  Dialogboxen  verzichten,  da  aus  diesen  kein  Fenster  geoff- 
net werden  kann.  Erst  die  ..modeless  dialog  boxes'*  (s.o.)  wiirden  ein  solches  System 
moglich  machen.  Doch  diese  existieren  noch  nicht  fur  GEM. 

Es  muB  hier  leider  auch  der  Aspekt  der  Raubkopien  kurz  angesprochen  werden.  Je  besser 
ein  Hilfesystem.  desto  leichter  kann  eine  Raubkopie  ohne  ein  dickes  Handbuch  weiterge- 
geben  werden.  Aus  diesem  Grand  muB  jeder  Entwickler  selbst  entscheiden,  wie  gut  er 
sein  Hilfesystem  implementieren  mochte. 


5.5  Datenaustausch 

Ein  wichtiges  Kapitel  stellt  auch  der  Datenaustausch  dar.  Bei  Rechnern  wie  dem  Macin- 
tosh halt  sich  jedes  Programm  an  die  vorgegebenen  Standards,  so  daB  mit  Leichtigkeit 
Daten  von  einem  Programm  in  ein  anderes  ubernommen  werden  konnen. 

Aus  irgendeinem  Grand  waren  aber  Entwickler  von  GEM-Software  nicht  in  der  Lage, 
sich  aufzuraffen  und  ebenfalls  Standards  zu  folgen.  Das  Resultat  da  von  sind  zwar  oft  recht 
gute  Programme,  aber  fast  alle  Programme  haben  ihre  eigenen  Formate  fur  Texte  und 
Grafiken.  Dies  ist  vor  allem  deswegen  unverstandlich,  weil  es  durchaus  Richtlinien  gibt, 
die  von  Digital  Research  beschrieben  wurden,  an  die  sich  aber  niemand  gehalten  hat. 

Doch  nun  beginnen  die  Software-Entwickler  umzudenken.  Allen  voran  haben  die  Ent- 
wickler von  1st  Wordplus  in  ihrer  neuesten  Version  den  Datenaustausch  moglich  ge- 
macht.  Wie  geht  dies  nun  vor  sich? 
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In  der  Beschreibung  der  GEM-Bibliotheken  existiert  die  sogenannte  SCRAP-Bibliothek. 
In  ihr  befmden  sich  Aufrufe  zur  Verwaltung  eines  Klemmbretts  (Clipboard).  Das  Klemm- 
brett  ist  nichts  weiter  als  ein  Inhaltsverzeichnis  (Ordner)  auf  einem  Datentrager.  In  die- 
sem  Inhaltsverzeichnis  befmden  sich  Dateien,  die  in  Standardformaten  abgelegt  sind.  Der 
Name  des  Verzeichnisses  hat  sich  in  den  verschiedenen  GEM-Versionen  gewandelt.  Bis 
zur  Version  GEM  2.X  hieli  dieses  GEMSCRAP  und  befand  sich  — zumindest  beim  PC 
— auf  dem  Laufwerk,  auf  dem  sich  das  gesamte  GEM-System  (GEMBOOT,  GEMSYS, 
GEMDESK,  GEMAPPS,  GEMSCRAP)  befand. 

Ab  GEM/3  hat  sich  dies  allerdings  geandert.  Da  hier  nur  noch  ein  Ordner,  namlich 
GEMAPPS  existiert,  in  welchem  sich  das  GEM-System  befmdet,  muB  sich  der  Ordner 
in  diesem  befmden.  Er  heiBt  hier  CLIPBRD,  der  vollstandige  Zugriffspfad  mithin 
C:\GEMAPPS\CLIPBRD\,  falls  sich  das  System  auf  Laufwerk  C befmdet.  Da  das  neue 
Wordplus  auch  fur  GEM/3  geeignet  ist  und  es  dort  Moglichkeiten  zum  Datenaustausch 
gibt,  muB  ebenfalls  der  Ordner  CLIPBRD  existieren.  Aus  diesem  Grund  und  um  kompati- 
bel  zu  spateren  Versionen  zu  bleiben,  schlagen  wir  diesen  Namen  vor. 

Bei  X/GEM  unter  FlexOS  hat  sich  der  Ordner  C:\BIN\SCRAP\  eingebiirgert. 

Innerhalb  des  Ordners  konnen  sich  nun  diese  Dateien  befmden.  Das  Inhaltsverzeichnis 
ist  nur  eine  Ebene  tief.  Das  bedeutet,  daB  zwei  Operationen,  die  jeweils  etwas  in  diesem 
Verzeichnis  speichern,  die  letzte  Version  uberschreiben.  Jedes  Programm  sollte  nun  die 
Moglichkeit  bieten,  auf  diese  Dateien  mittels  folgender  Operationen  zuzugreifen: 

Ausschneiden  (Cut):  Der  vorher  ausgewahlte  Block  wird  ausgeschnitten  und  aus  dem  Ori- 
ginal entfernt.  Vorher  wird  er  auf  das  Clipboard  geschrieben. 

Kopieren  (Copy):  Wie  „ Ausschneiden",  aber  ohne  Loschen  des  Originals. 

Einfiigen  (Paste):  Aus  dem  Clipboard  wird  das  entsprechende  Stuck  gelesen  und  an  der 
aktuellen  Cursorposition  eingefiigt. 

Da  das  Lesen  und  Schreiben  auf  Diskette  oder  Platte  im  Vergleich  zum  Hauptspeicher 
recht  langsam  geht,  kann  man  die  Cut/Copy/Paste-Funktionen  so  implementieren,  daB 
es  davon  jeweils  zwei  gibt.  Eine  Funktion  arbeitet  nur  im  Speicher,  die  andere  auf  dem 
Clipboard.  In  Wordplus  ist  dies  auf  die  eben  beschriebene  Weise  realisiert.  Das  Clipboard 
heiBt  dort  Puffer.  Zusatzlich  gibt  es  noch  die  Moglichkeit,  an  den  Puffer  im  Clipboard 
etwas  anzuhangen.  Es  bietet  sich  also  auch  noch  die  Funktion  Anhangen  (Append)  an. 
Das  Anhangen  ist  einfach  fur  Textdateien  zu  implementieren,  wird  Jedoch  fiir  Grafik 
schwierig,  wenn  nicht  der  gesamte  Inhalt  vorher  eingelesen  werden  soil. 

Um  Menus  zu  sparen,  sind  in  unserer  Beispielapplikation  die  jeweiligen  Menupunkte  fur 
das  Bearbeiten  nur  einmal  vorhanden.  Ein  Schalter  regelt  dann  die  Ausfiihrung  der  Ope- 
rationen derart,  daB  sie  entweder  im  Speicher  oder  auf  dem  Clipboard  (auf  den  GEM- 
Klemmbrett)  geschehen  (s.o.). 
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Die  Standardformate  sollten  von  jedem  Programm  verarbeitet  warden.  Digital  Research 
selbst  hat  bereits  Standardformate  vorgegeben,  und  unser  Vorschlag  ist  es,  sich  genau 
an  diese  zu  halten.  Die  Standardformate  werden  in  den  Unterlagen  zu  GEM  2.X,  GEM/3 
und  X/GEM  angegeben. 

Alle  Dateien  im  Clipboard,  auch  Scrap  genannt,  haben  den  gleichen  Namen,  aber  jeweils 
einen  verschiedenen  Suffix.  Folgende  Typen  bzw.  Dateibezeichnungen  werden  vorge- 
schlagen: 

SCRAP. CSV:  Die  Abkurzung  bedeutet  Comma-Separated- Values.  Leider  befindet  sich 
in  der  Originaldokumentation  keine  genaue  Beschreibung  dieses  Formats.  Wahrschein- 
lich  handelt  es  sich  einfach  um  eine  „endlose“  Liste  von  Zahlen  oder  Zeichenketten,  die 
jeweils  durch  Kommata  getrennt  sind. 

SCRAP.TXT:  Normaler  ASCH-Text  ohne  spezielle  Zeichen.  Alle  druckbaren  Zeichen 
des  Zeichensatzes  auf  dem  jeweiligen  Rechner  konnen  vorkommen.  Von  den  Steuerzei- 
chen  sollten  sinnvollerweise  nur  CR/LF  eventuell  auch  FF  vorkommen. 

SCRAP. GEM:  GEM-Metadateien  sollten  von  alien  objektorientierten  Zeichenprogram- 
men  unterstiitzt  werden.  Aber  auch  Texteditoren  sollten  diese  einlesen  und  wenigstens 
darstellen  konnen  (Beispiel:  Wordplus  unter  GEM/3  und  X/GEM).  Routinen  zu  ihrer 
Verarbeitung  werden  in  Kapitel  2 ausfiihrlich  dargestellt. 

SCRAP. IMG:  GEM-Bit-Image-Dateien  sollten  von  alien  pixelorientierten  Zelchenpro- 
grammen  zur  Verfiigung  gestellt  werden.  Aber  auch  Texteditoren  sollten  diese  einlesen 
und  wenigstens  darstellen  konnen.  (Beispiel:  Wordplus).  Routinen  zu  ihrer  Verarbeitung 
werden  in  Kapitel  2 ausfuhrlich  dargestellt. 

SCRAP.  DC  A:  Die  „Document  Contents  Architecture"  ist  ein  Standardformat  von  IBM. 
Leider  befindet  sich  in  der  Originaldokumentation  keine  genaue  Beschreibung  dieses 
Formats. 

SCRAP.USR:  OEM-defmiert. 

Zusatzlich  sollte  noch  mindestens  ein  weiteres  Format  unterstiitzt  werden: 

SCRAP. DIF:  Das  DIF-Format  dient  zum  Austausch  von  Daten  zwischen  Programmen 
fiir  Tabellenkalkulation,  Prasentationsgrafik  und  Datenbanken.  Ihr  Aufbau  wird  in  ver- 
schiedenen Literaturstellen  aufgezeigt. 

Jeder  Entwickler  hat  natiirlich  auch  die  Moglichkeit,  seine  eigenen  Formate  im  Clipboard 
abzulegen.  Wordplus  beispielsweise  legt  zu  jedem  auf  dem  Clipboard  abgespeicherten 
Teil  eines  Dokuments  zwei  Dateien  ab.  SCRAP.TXT  enthalt  den  ausgeschnittenen  Text 
im  ASCII-Format.  SCRAP.  IWP  im  1st  Wordplus-Format. 
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Die  Realisierung  des  Datenaustauschs  geschieht  nun  iiber  die  SCRAP-Bibliothek.  Dabei 
stehen  folgende  Funktionen  zur  Verfiigung: 

SCRP_READ:  Liest  das  Inhaltsverzeichnis  des  Clipboards  und  gibt  es  zuriick.  Zusatz- 
lich  werden  ab  GEM/3  als  Funktionswert  die  Typen  der  Dateien  zuriickgeliefert,  die  sich 
im  Clipboard  befinden.  Dabei  bedeutet  ein  Ruckgabewert  von  -1,  da6  kein  Inhaltsver- 
zeichnis existiert,  ein  Wert  von  0 zeigt  an,  dafl  das  Clipboard  leer  ist,  ansonsten  gilt: 

Bit  0:  SCRAP. CSV 

Bit  1:  SCRAP.TXT 

Bit  2:  SCRAP.GEM 

Bit  3:  SCRAP.IMG 

Bit  4:  SCRAP.  DC  A 

Bit  15:  SCRAP.USR 

Die  entsprechenden  Definitionen  wurden  von  uns  in  die  Headerdatei  AES.H  aufge- 
nommen. 

SCRP_ WRITE:  Setzt  das  aktuelle  Inhaltsverzeichnis  fur  das  Clipboard.  Dabei  wird 
kein  Ordner  erzeugt.  Dies  mud  mit  Standardbefehlen  des  Betriebssy stems  geschehen. 
Dasselbe  gilt  fiir  die  Dateien  im  Clipboard,  welche  mit  Standardbefehlen  gelesen  und  ge- 
schrieben  werden  miissen. 

Das  Inhaltsverzeichnis  wird  bis  GEM  2.X  immer  so  gespeichert,  wie  es  mittels 
SCRP  WRITE  geschrieben  wird,  d.h.  ein 

scrp_write  (”C;\\CLIPBRD”) 

liefert  beim  Lesen  uber  „scrp  read"  genau 

C:\CLIPBRD 

Ein 


scrp_write  (”C:\\CLIPBRD\\”) 
liefert  beim  Lesen  entsprechend 
C:\CLIPBRD\ 


Erst  ab  GEM/3  wird  an  der  letzten  Stelle  auf  jeden  Fall  ein  ’\’  zuriickgeliefert,  unabhan- 
gig  davon,  ob  dieses  Zeichen  beim  „scrp_write“  angegeben  wurde.  Wir  konnen  des- 
halb  nur  empfehlen,  auf  jeden  Fall  den  letzten  ’\’  anzugeben,  urn  kompatibel  zu  bleiben. 

SCRP  CLEAR:  Ab  GEM  2.X  gibt  es  auch  einen  Befehl  zum  Loschen  der  Dateien  im 
Clipboard.  Fur  den  ST  wird  dieser  Befehl  im  Modul  CLIPBRD  (Kapitel  6)  nachgebildet. 
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Bei  GEM/3  wird  auch  beim  ersten  SCRP_READ  ein  korrekter  Pfad  zuriickgeliefert, 
z.B.  C:\GEMAPPS\CLIPBRD\,  falls  sich  das  System  auf  Laufwerk  C befindet.  Das  be- 
deutet,  daB  alle  Programme  durch  einen  entsprechenden  SCRP_READ-Befehl  dieses 
Inhaltsverzeichnis  geliefert  bekommen  und  dadurch  der  Datenaustausch  vollstandig  ge- 
w^rleistet  ist. 

Leider  gilt  dies  nicht  fur  altere  GEM-Versionen.  Obwohl  bereits  ein  Ordner  vorgesehen 
war  (GEMSCRAP)  bringt  ein  SCRP_READ-Befehl  kein  Ergebnis.  Dies  bedeutet,  daB 
vorher  ein  SCRP_WRITE  geschehen  muB.  Nun  kommt  das  Problem:  Wenn  jedes  Pro- 
gramm  ein  SCRP_READ  benutzt,  um  den  Ordner  des  Clipboards  festzustellen  und  bei 
nichtvorhandenem  Ordner  ein  SCRP_ WRITE,  um  ihn  zu  setzen,  dann  kann  es  sein,  daB 
sich  sehr  viele  Ordner  auf  der  Diskette/Festplatte  befmden.  Dabei  wird  aber  immer  je- 
weils  nur  einer  als  aktuelles  Clipboard  benutzt.  Aus  diesem  Dilemma  gibt  es  nur  einen 
Ausweg:  Jeder  Entwickler  muB  den  gleichen  Namen  fiir  das  Clipboard  benutzen.  Wir 
empfehlen  den  bereits  fiir  GEM/3  und  durch  Wordplus  auch  auf  dem  Atari  eingefiihrten 
Namen:  CLIPBRD. 

Ein  weiteres  Problem  ergibt  sich  fiir  das  Laufwerk,  auf  dem  sich  der  Ordner  befmden 
muB.  Bei  GEM/3  ist  dies  kein  Problem,  da  hier  der  SCRP_READ-Befehl  auch  das 
Laufwerk  beinhaltet.  Beim  Atari  oder  bei  GEM  2.X  muB  jedoch  irgendein  Laufwerk  be- 
stimmt  werden.  Am  besten  ist  dies  ein  „schnelles“  Laufwerk,  also  eine  Festplatte  oder 
eine  RAM-Disk.  Beim  IBM  PC  kann  das  Laufwerk  C,  also  die  Festplatte  benutzt  werden, 
da  GEM  sowieso  nur  auf  Festplatte  einen  Sinn  macht. 

Folgender  Algorithmus  wird  nun  angewandt,  um  das  Inhaltsverzeichnis  des  Clipboards 
zu  bestimmen: 

1.  Ein  „scrp_read“  bestimmt,  ob  bereits  von  irgendeinem  Programm  ein  Inhaltsver- 
zeichnis gesetzt  wurde.  Dieses  wird  dann  benutzt.  Ab  GEM/3  und  X/GEM  wird  immer 
ein  giiltiges  Inhaltsverzeichnis  gefunden. 

2.  Ist  keines  gesetzt,  so  wird  beim  ST  nachgepriift,  ob  es  ein  schnelles  Laufwerk  gibt 
(ab  C aufwarts).  An  dieses  wird  der  Ordner  CLIPBRD  angehangt.  Gibt  es  kein  schnelles 
Laufwerk,  so  wird  Laufwerk  A benutzt.  Beim  PC  wird  das  Laufwerk  C benutzt.  An- 
schlieBend  wird  gepriift,  ob  sich  bereits  ein  Ordner  dort  befindet.  Ist  dies  der  Fall,  wird 
der  Ordner  als  Clipboard  weiterbenutzt. 

3.  Existiert  kein  Ordner,  so  wird  ein  Ordner  erzeugt.  Ist  das  Erzeugen  ordnungsgemaB 
vonstatten  gegangen,  wird  der  Ordner  benutzt. 

4.  Kann  der  Ordner  nicht  erzeugt  werden,  so  kann  auch  das  Clipboard  nicht  benutzt  wer- 
den, d.h.  die  Meniipunkte,  die  es  betreffen,  miissen  abgeschaltet  werden. 

Eine  elegante  Losung,  die  Schritte  2,  3 und  4 zu  ubergehen,  ist  die  Moglichkeit  von  Ac- 
cessories, ebenfalls  einen  Clipboard-Ordner  zu  erzeugen.  Wenn  Accessories  nach  oben 
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erwahntem  Algorithmus  vorgingen,  urn  einen  Ordner  zu  erzeugen  und  einen 
„scrp_write“-Befehl  ausfiihren  wurden,  so  wiirden  Applikationen  immer  schon  einen 
giiltigen  Pfad  finden. 

In  dem  in  Kapitel  6 beschriebenen  Beispielprogramm  wind  im  Modul  GLOBAL  die  oben 
beschriebene  Methode  benutzt.  Aufierdem  wird  der  fehlende  SCRP_CLEAR-Befehl  im 
Modul  CLIPBRD  implementiert  sowie  der  Riickgabewert  des  SCRP_READ-Befehls  an 
GEM/3  angepaBt. 

Wie  sollten  nun  Programme  vorgehen,  um  den  Datenaustausch  moglich  zu  machen? 
Zuerst  wird  wie  oben  beschrieben  das  Inhaltsverzeichnis  angelegt. 

Beim  Kopieren  (Copy)  in  das  Clipboard  wird  nun  entsprechend  den  angegebenen  Stan- 
dardformaten  jeweils  eine  Datei  SCRAP.???  erzeugt.  Die  drei  Fragezeichen  stehen  fiir 
die  jeweilige  Endung.  Bei  Texteditoren  bietet  sich  fur  ASCII-Text  SCRAP.TXT  an. 
SCRAP-Dateien  mit  eigener  Endung  wie  SCRAP.  IWP  oder  SCRAP.  SDO  konnen  selbst- 
verstandlich  ebenso  zusatzlich  geschrieben  werden.  Fiir  objektorientierte  Zeichenpro- 
gramme  gilt  das  gleiche  fiir  Metadateien  mit  Endung  GEM,  fiir  pixelorientierte  Program- 
me entsprechendes  fur  Bit-Image-Dateien  mit  Endung  IMG. 

Beim  Ausschneiden  (Cut)  wird  selbstverstandlich  die  gleiche  Methode  angewandt.  Ledig- 
lich  das  Original  wird  dabei  zusatzlich  geloscht. 

Beim  Einfiigen  (Paste)  aus  dem  Clipboard  wird  zuerst  gesucht,  ob  sich  eine  entsprechende 
Datei  iiberhaupt  dort  befindet.  Nur  dann  ist  der  Meniipunkt  anwahlbar.  Dann  wird  die 
Datei  aus  dem  Inhaltsverzeichnis  gelesen.  Dies  kann  auch  mehrere  Male  geschehen. 

Ein  weiteres  wichtiges  Kriterium  zum  Thema  Datenaustausch  betrifft  den  Aufruf  anderer 
Applikationen  aus  einer  bestehenden  Applikation.  Beispielsweise  mochte  man  ein  Text- 
programm  verlassen,  weil  man  die  Grafik,  die  man  eben  eingebunden  hat,  noch  einmal 
uberarbeiten  mochte.  Am  besten  ware  ein  Aufruf  des  Grafikprogrammes,  an  welches  man 
als  Parameter  die  Grafik  iibergibt,  die  man  bearbeiten  mochte.  Nach  Bearbeiten  der  Gra- 
fik sollte  man  sich  wieder  im  Textprogramm  befinden. 

Beim  ST  geht  dies  am  einfachsten,  wenn  man  andere  Programme  iiber  die  GEMDOS- 
Funktion  „Pexec“  aufruft.  Dann  ist  man  nach  der  Riickkehr  automatisch  an  der  richtigen 
Stelle  im  aufrufenden  Programm.  Reicht  der  Speicher  aber  nicht  aus,  was  bei  IBM  PCs 
praktisch  immer  der  Fall  ist,  so  muB  man  einen  „shel_ write"  Befehl  benutzen.  Das  auf- 
rufende  Programm  ist  dann  aber  nicht  mehr  im  Speicher. 

Die  einzige  Rettung  besteht  darin,  dem  aufgerufenen  Programm  mitzuteilen,  von  wo  es 
aufgerufen  wurde.  Bei  den  GEM-Versionen  auf  dem  IBM  PC  wird  dies  bei  alien  Pro- 
grammen  gemacht,  welche  das  OUTPUT. APP  aufrufen.  Von  diesem  Programm  kann 
man  dann  wieder  das  aufrufende  Programm  starten.  Mitgeteilt  wird  dies  dem  OUT- 
PUT.APP  durch  eine  standardisierte  Nachricht  beim  „shel_write“-Befehl.  Dabei  wird 
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neben  dem  Parameter  auch  der  Name  des  aufrufenden  Programms,  getrennt  durch  einen 
7’,  iibergeben.  Fiir  GEMDRAW,  welches  DRAW.APP  heifit  und  der  Grafik 
TEST. GEM  heiftt,  der  Parameter  „tail“  im  „shel  write": 


TEST . GEM/DR  AW . APP 

Das  Programm  OUTPUT.  APP  extrahiert  hiervon  den  Parameter  TEST. GEM  und  das 
aufrufende  Programm  DRAW.APP.  Dieses  kann  dann  wieder  von  OUTPUT. APP  aufge- 
rufen  werden,  so  daB  sich  die  Wirkung  eines  Unterprogrammes  ergibt.  Dadurch  ist  ein 
Wechsel  von  einem  Programm  in  ein  anderes  moglich,  welches  wiederum  das  aufrufende 
Programm  ausfiihren  kann.  OUTPUT. APP  ruft  dann  ein  „shel_write“  mit 


TEST.  GEM/OUTPUT . APP 

auf.  Fiir  GEM  2.X  und  neuere  Versionen  gibt  es  allerdings  noch  eine  andere  Mdglichkeit: 
Die  Befehle  „shel_rdef“  und  „shel_wdef“  verwalten  das  Standardprogramm,  welches 
nach  Verlassen  eines  Programmes  aufgerufen  wird.  Damit  kann  verhindert  werden,  daB 
nach  Beendigung  eines  Programms  der  Desktop  zum  Zuge  kommt.  Stattdesssen  wird  das 
durch  „shel_wdef“  definierte  Programm  gestartet. 

Als  Regel  sei  an  dieser  Stelle  erwahnt,  sicherheitshalber  einen  vorhandenen  7’  im  Para- 
meterteil  vom  eigentlichen  Parameter  abzutrennen,  um  den  Namen  des  aufrufenden  Pro 
gramms  herauszubekommen.  Existiert  kein  7’,  so  handelt  es  sich  um  den  Desktop  oder 
ein  anderes  Programm,  welches  seinen  Namen  nicht  an  den  Parameter  anhangt.  Auf  jeden 
Fall  gilt  diese  Regel  fiir  alle  Programme,  die  nicht  nur  vom  Desktop  aus  aufgerufen  wer- 
den kdnnen,  wie  z.B.  OUTPUT. APP. 


Sollen  mehrere  Parameter  an  ein  Programm  iibergeben  werden,  so  miissen  diese,  wenn 
sie  uber  „shel_read“  gelesen  werden,  durch  ein  Trennzeichen  getrennt  werden.  Der 
Desktop  von  GEM  2.X  und  spateren  Versionen  ubergibt  beispielsweise  an  OUTPUT 
mehrere  GEM-Dateien,  wenn  man  diese  zuerst  anklickt  und  dann  den  Meniipunkt  „An 
Ausgabe"  anwahlt.  Die  Dateinamen  werden  dabei  durch  Kommata  getrennt.  Wird  nur 
an  den  ersten  der  komplette  Pfad  angehangt,  so  befinden  sich  die  anderen  Dateien  auf 
dem  gleichen  Inhaltsverzeichnis.  Mochte  man  noch  den  Namen  des  aufrufenden  Pro- 
gramms einbringen,  so  muB  dies  hinter  dem  letzten  Parameter  geschehen.  OUTPUT  er- 
laubt  aber  auch  die  Ubergabe  von  mehreren  Parametern,  welche  durch  ein  Leerzeichen 
getrennt  sind.  So  sind  giiltige  Beispiele  fiir  Parameter; 

C : \GEM  APPSXTEST 1 . GEM  ,TEST2 . GEM 

C:\GEMAPPS\TEST1.GEM  TEST2.GEM 


C:\GEMAPPS\TEST1. GEM,TEST2.GEM/DRAW.APP 
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5.6  Ausgabe  von  Daten 

Ein  immer  wiederkehrendes  Problem  ist  die  Ausgabe  von  Daten  auf  dem  Drucker  oder 
einem  anderen  Ausgabegerat.  Jedes  Progratnm  hat  seine  eigenen  Moglichkeiten  vorgese- 
hen.  So  mull  bei  Wordplus  eine  entsprechende  Konfigurationsdatei  geladen  werden,  bei 
Signum  gibt  es  verschiedene  Programme  fur  verschiedenartige  Drucker  usw. 

Dem  Benutzer  ist  bei  dieser  Situation  nicht  unbedingt  geholfen.  Er  muB  fiir  jedes  Pro- 
gramm  immer  wieder  Druckerinstallationen  vornehmen.  Meist  hat  er  einen  oder  zwei 
verschiedene  Drucker  an  seinem  System  angeschlossen.  Hervorragend  ware  nun  die 
Mdglichkeit,  diese  ein  fiir  allemal  festzulegen  (zumindest  bis  zu  einem  neuen  Drucker- 
kauf),  und  die  einzelnen  Programme  wiirden  iiber  eine  Standardschnittstelle  an  die  ent- 
sprechenden  Gerate  ausgeben. 

Bei  GEM  auf  dem  PC  ist  dieser  Weg  gegangen  worden.  Dort  wird  das  GEM  fiir  eine 
bestimmte  Konfiguration  eingestellt.  Einmal  konfiguriert,  kann  nun  der  Benutzer  bestim- 
men,  auf  welches  Ausgabegerat  seine  Daten  geschickt  werden  sollen.  Dabei  werden  Stam 
dardformate  verwendet,  die  Jedes  Programm  erzeugen  kann.  Ein  entsprechendes  Ausga- 
beprogramm,  namlich  OUTPUT.  APP  gibt  dann  die  entsprechenden  Dateien  auf  das  Aus- 
gabegerat aus. 

Der  Vorteil  von  OUTPUT  liegt  in  dessen  freier  Konfigurierbarkeit.  Beim  Installieren  von 
GEM  konnen  nahezu  beliebige  Ausgabegerate  eingestellt  werden  wie  Matrixdrucker, 
Laserdrucker,  Plotter  oder  Kamera.  Wird  an  OUTPUT  eine  Metadatei  iibergeben,  so 
wird  sie  anstandslos  auf  dem  eingestellten  Ausgabegerat  ausgegeben.  Das  gleiche  gilt  fiir 
Bit-Image-Dateien . 

Fiir  ASCII-Texte  wird  ebenfalls  ein  Standardformat  benutzt.  Es  handelt  sich  um  Dateien 
mit  dem  Suffix  OUT.  Dieses  Format  wurde  in  Kapitel  2 beschrieben.  Tatsachlich  arbeitet 
die  neue  Version  von  Wordplus  auf  dem  PC  mit  OUTPUT  zusammen.  Dabei  wird  statt 
dem  direkten  Druck  eine  entsprechende  OUT-Datei  erzeugt  und  diese  an  OUTPUT  iiber- 
geben.  Dort  kann  man  dann  bestimmen,  auf  welches  Ausgabegerat  gedruckt  werden  soli. 
Sogar  ein  Drucken  im  Hintergrund  ist  mit  Hilfe  des  Spoolers  CALCLOCK  moglich. 

Die  Definitionen  der  Einstellungen  in  der  OUT  Datei  sind  in  der  Headerdatei  VDI.H  auf- 
gefiihrt.  Dort  sind  alle  Einstellungen  zum  Drucken  von  Texten  mit  samtlichen  Attributen, 
also  fett,  kursiv,  unterstrichen,  schmal,  breit  usw.  aufgefiihrt. 

Auf  dem  ST  mit  seinem  groBen  Speicher  konnte  man  ohne  Probleme  ebenfalls  ein  solches 
Programm  schreiben,  das  auch  als  Accessory  im  Hintergrund  drucken  konnte.  Die  An- 
passung  an  das  jeweilige  Ausgabegerat  wird  dann  von  diesem  einen  Accessory  ein  fiir 
allemal  fur  alle  Applikationen  iibernommen.  Das  wiirde  bedeuten,  daB  der  Benutzer  nur 
noch  einmal  seine  Konfiguration  angibt.  Die  Applikationen  erzeugen  dann  entweder 
OUT-,  GEM-  oder  IMG-Dateien.  In  den  OUT-Dateien  gibt  es  auch  Befehle,  um  Meta- 
dateien  und  Bit-Image-Dateien  zu  drucken,  so  daB  Text  und  Grafik  gemischt  werden 
konnen. 


5.  7 Allgemeindes 
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Fiir  alle  langer  andauernden  Routinen  (vor  alletn  Ausgaberoutinen)  solUe  auberdem  gel- 
ten,  daB  sie  jederzeit  durch  eine  Taste,  am  besten  „Esc“  und/oder  „Undo“  (nicht  auf  dem 
PC)  Oder  auch  z.B.  durch  Driicken  beider  Shift-Tasten,  abgebrochen  werden  kdnnen. 

Dieses  Konzept  des  universellen  Ausgabeprogramms  ist  zumindest  fiir  alle  Programme 
interessant,  die  nur  Text  oder  Grafik  in  den  Standardformaten  ausgeben,  also  z.B.  fiir 
alle  Textverarbeitungs-,  Datenbank-  und  Tabellenkalkulationsprogramme.  Die  Ausgabe- 
routinen fiir  Meta-  und  Bit-Image-Dateien  wurden  bereits  in  Kapitel  2 beschrieben,  ein 
Interpretierer  fiir  das  OUT-Format  ist  ebenso  leicht  zu  schreiben. 


5.7  Aligemeines 

An  dieser  Stelle  sollen  noch  einige  allgemeine  Tips  zur  Standardisierung  gegeben  werden. 

— Bildschirmauflosung 

Es  gibt  immer  noch  viele  Programme,  welche  die  Auflosung  des  Bildschirms  mittels  Ge- 
trez()  erfragen.  Stellt  sich  heraus,  daB  es  sich  um  eine  niedrige  Auflosung  handelt,  so 
lauft  das  Programm  deswegen  nicht  los,  weil  es  davon  ausgeht,  daB  die  Meniizeile  nicht 
auf  den  Bildschirm  paBt.  Nicht  nur  seit  der  Zeit  als  GroBbildschirme  eingefiihrt  wurden, 
sondern  spatestens  bei  der  Einfiihrung  des  Atari  TT  machen  diese  Programme  eine 
schlechte  Figur.  Viele  Farben  bedeuten  noch  lange  nicht,  daB  nur  40  Zeichen  in  einer 
Zeile  dargestellt  werden  kdnnen. 

Entwickler  kdnnen  bereits  heute  ihre  Programme  auf  groBe  Auflosung  testen,  indem  sie 
softwaremaBig  emulierte  GroBbildschirme  einsetzen,  wie  z.B.  „Bigscreen“  von  Julian 
Reschke.  Viele  Programme  laufen  nicht  im  640x400  Modus  mit  16  Farben,  obwohl  sie 
es  kdnnten.  Dies  gilt  natiirlich  nicht  fur  in  Assembler  geschriebene  Spiele,  die  ihre  Ausga- 
be  direkt  ins  Video-Ram  schmieren.  Aber  solche  Programme  laufen  mit  Sicherheit  auch 
nicht  auf  dem  TT. 

— Vektorverbiegende  Programme 

Fiir  vektorverbiegende  Programme  wurde  inzwischen  das  XBRA-Protokoll  (extended 
BRAner  von  Moshe  Braner)  erfolgreich  von  Julian  Reschke  eingefiihrt  (siehe  auch  ver- 
schiedene  Artikel  im  ST  Magazin).  Damit  kdnnen  Programme  leichter  feststellen,  ob  sie 
schon  installiert  sind  und  kdnnen  sich  leichter  aus  der  Vektorkette  ausklinken.  Auch  wenn 
dies  wohl  ein  Verfahren  ist,  das  nur  bei  den  wenigsten  Programmen  zum  Einsatz  kommt, 
sollten  alle  Programme,  die  es  betrifft,  zum  Schutz  des  Benutzers  dieses  Standardverfah- 
ren  einsetzen. 

— Speicherplatz 

Jede  Applikation  sollte  nur  soviet  Speicherplatz  allozieren,  wie  sie  wirklich  bendtigt.  Dies 
gilt  vor  allem  fiir  Accessories  und  Programme  im  Auto-Ordner. 
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— AusgabegroBe 

Jede  Applikation  sollte,  soweit  die  AusgabegroBe  bekannt  oder  berechenbar  ist,  vor  dem 
Sichem  den  freien  Speicherplatz  auf  dem  gewahlten  Speichermedium  abfragen  und  ggf. 
eine  Umlenkung  vorschlagen. 

Da  das  Abfragen  des  freien  Speicherplatzes  von  Festplatten  bei  alteren  TOS-Versionen 
etwas  langer  dauert,  Festplatten  aber  wiederum  selten  voll  beschrieben  werden,  kann  sich 
die  Abfrage  im  Prinzip  auf  die  Laufwerke  A und  B beschranken. 


6 Ein  universelles  Modulkonzept  in  C 


In  diesem  Kapitel  soil  erklart  werden,  wie  man  in  der  Sprache  C Module  schreibt,  die 
mdglichst  unabhangig  voneinander  sind.  Sprachen  wie  z.B.  Modula-2  unterstiitzen  dieses 
Konzept  sehr  stark.  Modula  ist  deshalb  auch  die  Sprache,  welche  man  als  echte  Alternati- 
ve zu  C lernen  sollte.  Doch  auch  in  C ist  es  moglich,  Module  mit  genau  defmierten 
Schnittstellen  zu  entwickeln. 

Seit  Einfuhrung  der  ANSI-C-Compiler  wird  diese  Entwicklung  sogar  noch  begiinstigt, 
da  nun  auch  Parameter  von  Funktionen  auf  ihre  Gultigkeit  iiberpruft  und  gegebenenfalls 
angepaBt  werden.  Die  Funktionalitat  eines  ANSI-C -Compilers  reicht  sogar  soweit,  daB 
man  gewarnt  wird,  wenn  man  eine  Funktion  aufrufen  mochte,  die  nicht  vorher  definiert 
wird.  Dadurch  ergibt  sich  ein  ahnlicher  Effekt  wie  bei  Modula  oder  auch  Pascal.  Bei  der 
Ubersetzung  von  Programmen,  in  welchen  Funktionen,  die  nicht  definiert  sind,  aufgeru- 
fen  werden,  wird  sofort  eine  Fehlermeldung  ausgegeben. 

.-A 

Wir  werden  auf  den  Aufbau  von  Modulen  in  C in  6.2  zu  sprechen  kommen  und  erklaren, 
warum  es  so  wichtig  ist.  Programme  in  Module  zu  unterteilen. 


6.1  Ziel  der  Beispielapplikation  SCRAP 

Bevor  wir  uns  auf  die  einzelnen  Module  der  Beispielapplikation  stiirzen,  sollen  zunachst 
die  Ziele  vorgestellt  werden,  die  wir  verfolgen.  Von  diesen  Zielen  ausgehend,  kann  man 
dann  die  einzelnen  Aufgaben  definieren  und  auf  Module  verteilen. 

Die  Applikation  wird  SCRAP  heiBen  und  soil  die  Verwaltung  eines  System-Klemmbretts 
bereitstellen.  Das  System-Klemmbrett  ist  ein  Inhaltsverzeichnis  auf  der  Festplatte  oder 
Diskette.  In  dieses  konnen  Programme  kleine  Stiickchen,  auch  Scraps  genannt,  hinein- 
schreiben  oder  auslesen.  Die  Dateien,  die  sich  in  diesem  Inhaltsverzeichnis  befinden,  hei- 
Ben alle  SCRAP,  haben  jedoch  einen  spezifischen  Suffix  (z.B.  SCRAP. GEM).  An  diesem 
erkennt  man,  um  welche  Art  von  Datei  es  sich  handelt. 
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Die  Applikation  soli  wiederum  ein  solches  Inhaltsverzeichnis  suchen.  Wenn  noch  keines 
existiert,  soil  es  dieses  anlegen.  Dann  wird  das  Inhaltsverzeichnis  in  einem  Fenster  mit 
Hilfe  von  Piktogrammen  angezeigt.  Auf  Wunsch  sollte  auch  Textdarstellung  mdglich 
sein,  ahniich  wie  im  Desktop.  Das  verschiedene  Aussehen  der  Piktogramme  spiegelt  die 
Art  wider,  urn  die  es  sich  handelt.  In  Abbildung  6.1  wird  ein  Beispiel  fur  ein  Fenster 
mit  verschiedenen  Piktogrammen  gezeigt. 
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Abbildung  6,1:  Piktogramme  der  Scrap-Directory 


Die  Piktogramme  sollen  nun  angeklickt  und  gedffnet  werden  kdnnen,  Dann  erscheint  je 
nach  Art  des  Piktogramms  ein  Fenster,  welches  den  Inhalt  der  Datei  anzeigt.  Das  bedeu- 
tet,  dah  je  nach  Art  ein  anderer  Algorithmus  angewandt  werden  muh.  Drei  Arten  werden 
vom  Programm  verarbeitet.  Metadateien,  Bit-Image-Dateien  und  normaler  ASCII-Text. 
Die  Datei  mit  Suffix  GEM  wird  als  Metadatei,  die  mit  Suffix  IMG  als  Bit-Image-Datei 
und  alle  anderen  werden  als  Textdatei  gedffnet. 

Die  Bedienung  des  Klemmbretts  selbst  soli  in  einer  Umgebung  geschehen,  welche  einen 
eigenen  Desktop  zur  Verfiigung  stellt.  Dies  ist  nicht  unbedingt  ndtig,  aber  das  Programm 
soil  einige  Techniken  aufzeigen,  wie  man  einen  eigenen  Desktop  verwaltet. 

Dariiberhinaus  sollen  zwei  weitere  Arten  von  Fenstern  gedffnet  werden  kdnnen,  die  aber 
nur  der  Demonstration  dienen  sollen.  Es  handelt  sich  zum  einen  um  eine  Art  von  Fenster, 
welche  Potenzen  einer  Zahl  zwischen  zwei  und  neun  darstellt.  Dort  werden  die  Pop-Up- 
Mentis  und  ein  eigener  Mauscursor  veranschaulicht.  Zum  anderen  sollen  Fenster  gedffnet 
werden,  welche  eine  Ellipse  mit  verschiedenen  Mustern  zeichnet,  die  der  Benutzer  inter- 
aktiv  einstellen  kann.  An  diesem  Fenster  wird  eine  Art  Multitasking-Betrieb  veran- 
schaulicht. 

Die  Bedienung  soli  intuitiv  und  einheitlich  sein.  So  kann  man  jedes  Objekt  jederzeit  an- 
wahlen  und  eine  Info-  oder  Hilfe-Tafel  einblenden.  Dies  soli  auch  bei  nicht  aktiven  Objek- 
ten  geschehen  kdnnen.  Die  Information  oder  Hilfe  bezieht  sich  dann  auf  das  oberste 
Fenster. 

Am  Clipboard-Fenster  wird  auBerdem  eine  eigene  Meniizeile  demonstriert. 


6.2  Aujbau  und  Aufgaben  der  Module 


341 


Das  ganze  Programm  soil  dariiberhinaus  uberall  dort  lauffahig  sein,  wo  GEM  zur  Ver- 
fiigung  steht.  An  den  Quelltexten  soil  kein  einziges  Byte  geandert  werden  miissen,  wenn 
es  auf  einen  anderen  Rechner  oder  ein  anderes  GEM  iibertragen  wird.  Es  soli  lediglich 
neu  compiliert  und  gelinkt  werden.  Das  Programm  soil  soweit  auch  betriebssystem-  und 
rechnerunabhangig  sein.  AuBerdem  soil  es  auch  als  Accessory  im  Hintergrund  laufen 
konnen,  ohne  daB  dabei  die  Funktionalitat  darunter  leidet.  Ahnliches  soli  fiir  die  Auf- 
losung  gelten.  Es  soil  unerheblich  sein,  ob  es  auf  dem  Atari  unter  den  drei  verschiedenen 
Auflosungen  lauft  oder  auf  einem  PC  mit  einer  entsprechenden  Grafikkarte.  Ein  weiterer 
Punkt  ist  die  Compilerunabhangigkeit.  Sie  sollen  sich  fiir  Ihren  Lieblingscompiler  ent- 
scheiden  konnen.  Er  sollte  allerdings  nicht  allzu  fehlerhaft  sein,  wie  dies  Vorversionen 
bestimmter  Compiler  schon  waren.  Wir  konnen  aber  nur  eine  Garantie  auf  Lauffahigkeit 
fiir  die  in  Kapitel  drei  aufgefiihrten  Compiler  ubernehmen,  da  diese  getestet  wurden. 

Falls  das  Programm  als  Accessory  gestartet  wird  (im  Prinzip  nur  sinnvoll  auf  einem  Atari 
ST),  so  soil  es,  urn  keine  Funktionalitat  einzubii6en,  den  Desktop  in  ein  Fenster  legen, 
da  dieser  der  Hauptapplikation  gehort.  Ahnliches  gilt  fiir  die  Meniizeile.  Sie  soli  sich  dann 
innerhalb  des  Desktop-Fensters  befmden  und  nach  Anklicken  genauso  zu  bedienen  sein 
wie  die  Hauptmeniizeile. 


6.2  Aufbau  und  Aufgaben  der  Module 

Um  zu  verstehen,  worum  es  in  diesem  Abschnitt  geht,  sollte  zunachst  einmal  der  Begriff 
des  Moduls  definiert  werden: 

Unter  einem  Modul  verstehen  wir  einen  klar  umrissenen,  in  sich  abgeschlossenen  Teil 
eines  Programmsystems,  der  eine  fiinktional  spezifizierte  Teilaufgabe  implementiert.  Die 
Beschreibung  der  Modulfunktion  bildet  seine  Schnittstelle.  Uber  diese  tritt  ein  Modul  mit 
seiner  Umgebung  in  Beziehung. 

Eine  Schnittstelle  muB  moglichst  unabhangig  von  den  Algorithmen  sein,  mit  denen  ein 
Modul  implementiert  ist.  Dieses  Prinzip  nennt  man  auch  „Information  Hiding",  da  die 
internen,  die  Implementierung  betreffenden  Einzelheiten  lokal  gehalten  und  nicht  an  die 
Umgebung  weitergegeben  werden. 

Bei  der  Definition  der  Schnittstelle  sollte  darauf  geachtet  werden,  daB  diese  so  minimal 
wie  moglich  gehalten  wird.  Damit  vermindert  man  den  Kommunikationsaufwand,  ver- 
meidet  MiBverstandnisse  und  verhindert  letztlich  Fehler,  die  aufgrund  falscher  Annah- 
men  bei  umfangreichen  Schnittstellen  sehr  leicht  entstehen  konnen. 

Beispiele  fur  Module  sind  unter  anderem  die  mathematischen  Funktionen  wie  „sin(x)“. 
Fiir  jeden  Wert  „x“  wird  hier  eine  Ausgabe  geliefert.  Die  Schnittstelle  besteht  nur  aus 
der  einen  Funktion  und  der  Vorgabe,  wie  das  x und  der  Funktionswert  zu  interpretieren 
sind.  Wie  die  Funktion  „sin(x)“  nun  den  Sinus  genau  berechnet,  also  iiber  Tabellen  oder 
durch  Berechnung  der  Potenzreihe,  interessiert  den  Aufrufer  nicht.  Wichtig  ist,  was  hin- 
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eingesteckt  wird  und  was  danach  herauskommt.  Aufierdem  mufi  die  Sinus-Funktion  nicht 
neu  iibersetzt  werden,  wenn  das  aufrufende  Modul  verandert  wird.  Es  wurde  einnial  iiber- 
setzt  und  liegt  damit  jederzeit  bereit,  zu  einem  Programm  hinzugebunden  zu  werden. 

In  der  Sprache  Modula-2  werden  Module  durch  eine  Schnittstelle  und  eine  Implementie- 
rung  beschrieben.  Dort  gibt  es  zwei  getrennte  Dateien,  namlich  mit  Endung  DEF  fiir  die 
Definition  und  mit  Endung  MOD  fiir  die  Implementierung.  Mochte  nun  ein  Modul  Funk- 
tionen  aufrufen,  welche  in  einem  anderen  Modul  definiert  sind,  so  muB  es  diese  importie- 
ren.  Umgekehrt  kann  ein  Modul  Funktionen  aber  auch  Konstanten,  Typen  und  Variablen 
exportieren  und  sie  so  anderen  Modulen  zuganglich  machen.  Was  ein  Modul  nicht  expor- 
tiert,  kann  nicht  von  einem  anderen  Modul  benutzt  werden. 

Eine  wichtige  Eigenschaft  von  Modulen  ist  auch  die  der  getrennten  Ubersetzbarkeit.  Dies 
hangt  natiirlich  von  der  gewahiten  Sprache  ab.  In  Modula,  aber  auch  in  C ist  dies  ohne 
weiteres  moglich. 

Ein  Beispiel  bei  Verwendung  der  Funktion  „WriteInt“  aus  dem  Modul  „InOut“: 

MODULE  Test; 

FROM  InOut  IMPORT  Writeint;  (*  Damit  1st  die  Funktion  slchtbar  *) 

BEGIN 

Writeint  (3,  10); 

END  Test. 

Mit  diesem  Programm  wird  die  Zahl  drei  auf  zehn  Stellen  rechtsbUndig  ausgegeben.  Wiir- 
de  die  Zeile  „FROM...“  fehlen,  so  wiirde  der  Compiler  bei  Erreichen  der  Zeile  „Wri- 
telnt(3,  10)“  feststellen,  dal)  er  die  Funktion  nicht  kennt  und  sich  weigern,  Code  zu  erzeu- 
gen  und  damit  das  Programm  ablauffahig  zu  machen.  Und  das  ist  auch  gut  so.  Durch 
den  Import  der  Funktion  kennt  der  Compiler  die  Parameter  und  kann  nun  leicht  testen, 
ob  zum  Beispiel  der  zweite  Parameter,  der  die  Feldbreite  angibt,  fehlt  oder  ob  die  Typen 
der  Parameter  libereinstimmen. 

In  der  Sprache  C war  es  bisher  iiblich,  Funktionen  einfach  aufzurufen  und  dem  Linker 
die  Sorge  zu  tiberlassen,  wo  er  die  Funktion  finden  und  dazubinden  soil.  Was  die  Parame- 
ter angeht,  so  konnte  man  bisher  ohne  Probleme  auch  mal  mehr  oder  weniger  Parameter 
an  eine  Funktion  iibergeben.  Das  bedeutete  aber,  dal)  zur  Laufzeit  das  Programm  mit  gro- 
Ber  Wahrscheinlichkeit  abstiirzte  oder  zumindest  merkwiirdige  Ergebnisse  zur  Folge 
hatte. 

Unser  Beispiel  von  oben  wiirde  in  Standard-C  etwa  so  aussehen: 
main  ( ) 

J 

prlntf  3); 

] /*  main  */ 
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Diese  Zeilen  warden  ebenfalls  die  Zahl  3 auf  10  Stellen  rechtsbiindig  ausgeben.  Weder 
der  Compiler  noch  der  Linker  batten  allerdings  etwas  dagegen,  wenn  wir  den  „printf“- 
Befehl  in 

printf  (3,  10); 

umwandeln  wiirden. 

Anders  sieht  dies  bei  den  modernen  ANSI-C-Compilern  aus.  Sie  wollen  fiir  jede  Funktion 
auch  einen  Prototyp.  Der  Prototyp  bezeichnet  die  Funktion  mit  ihren  Parametern.  Stan- 
dardfunktionen  wie  „printf“ , die  sich  in  jeder  C-Bibliothek  befinden,  haben  genauso  Pro- 
totypen  wie  eigene  Funktionen,  Wird  nun  obiges  Programm  beispielsweise  mit  dem 
Turbo-C -Compiler  iibersetzt,  dann  wurde  er  eine  Warnmeldung  bringen,  dafi  der  Proto- 
typ von  „printf“  fehlt.  Diesen  benotigt  er  einerseits  fiir  die  Parameteruberpriifung,  ande- 
rerseits  dafiir,  sich  auszurechnen,  wieviele  Parameter  er  in  Registern  iibergeben  kann. 
Um  den  Prototyp  sichtbar  zu  machen,  muB  eine  Datei,  in  der  ein  solcher  Prototyp  steht, 
in  das  Programm  aufgenommen  werden.  Dies  geschieht  bekanntlich  mit  der  „include“- 
Direktive.  Wir  wiirden  also  unser  Programm  erweitern,  indem  wir  als  erstes  ein 

# include  <stdio.h> 

einfiigen. 

Daraufliin  wird  der  C-Compiler  zufrieden  sein,  da  sich  der  Prototyp  fiir  die  Funktion 
„printf“  in  der  Datei  „stdio.h“  befindet.  Er  lautet 

int  printf  (const  char  *format,  ...); 

Das  bedeutet,  daB  ein  „printf“-Aufruf  immer  zuerst  eine  Zeichenkette  erwartet,  dann  eine 
beliebige  Anzahl  von  Parametern  (sie  hangen  von  der  Zeichenkette  ab). 

1st  ein  solcher  Prototyp  einmal  defmiert,  wird  der  Compiler  auch  unseren  falschen 

printf  (3,  10); 

Befehl  nicht  annehmen.  Wir  sind  also  vor  unliebsamen  Uberraschungen  sicher.  Die  Funk- 
tion „printr‘  befindet  sich  im  Modul  „stdio“  in  einer  Bibliothek.  Eine  solche  Bibliothek 
verfiigt  meist  iiber  sehr  viele  Funktionen,  die  dann  in  den  entsprechenden  Header- Dateien 
(Suffix  „H“).  beschrieben  werden.  Diese  Module  werden  von  den  Compiler-Entwicklern 
mitgeliefert.  Um  zu  erreichen,  dafi  Programme  mit  vielen  Compilem  lauffahig  sind,  muB 
man  bei  der  Wahl  der  Funktionen  darauf  achten,  daB  diese  in  jeder  Compiler-Bibliothek 
vorhanden  sind,  Glucklicherweise  gibt  es  eine  Reihe  von  Funktionen,  die  bei  jedem  Com- 
piler die  gleichen  Effekte  haben. 

Um  nun  eine  Schnittstelle  in  C zu  erstellen,  werden  wir  ebenfalls  fiir  jedes  Modul  zwei 
Dateien  erstellen.  Die  Schnittstellenbeschreibung  wird  in  der  Datei  mit  Suffix  „H“  einge- 
tragen,  der  eigentliche  Programmcode  in  der  Datei  mit  Suffix  „C“,  also  z.B.  GLOBAL.H 
und  GLOBAL.C. 
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In  der  Header-Datei  werden  alle  Konstanten,  Typen,  Variablen  und  Funktionen  eingetra- 
gen,  die  von  den  anderen  Modulen  importiert  werden  konnen,  also  von  anderen  Modulen 
aus  sichtbar  sind.  Beispiele  sind  die  Dateien  auf  der  mitgelieferten  Diskette,  die  mit  Suffix 
„H“  versehen  sind. 

Ein  Problem  ergibt  sich  nun,  wenn  Variablen,  die  in  einer  Header-Datei  defmiert  sind, 
sowohl  von  anderen  (importierenden)  Modulen,  als  auch  vom  exportierenden  Modul  be- 
notigt  werden.  Variablen,  die  in  C zwar  angesprochen  werden  konnen,  jedoch  keinen 
Speicherplatz  belegen,  sind  externe  Variablen.  Sie  werden  in  irgendeinem  anderen  Modul 
defmiert,  wo  sie  auch  Speicherplatz  zugewiesen  bekommen.  Im  folgenden  Beispiel  sei 
„gl_apid“  zunachst  eine  Variable,  die  von  mehreren  Modulen  benutzt  wird,  aber  nur 
in  einem  Modul  Speicherplatz  belegt.  In  diesem  (exportierenden)  Modul  (Moduli)  wird 
die  Definition  und  ein  Benutzen  der  Variablen  z.B.  folgende  Gestalt  annehmen: 

/***¥:*  MODULI. C 

# include  <portab.h> 

WORD  gl_apid; 

WORD  wert; 

LOCAL  VOID  testl  () 


gl_apid  = appl_init  (); 
wert  = 5; 

j /»  testl  */ 

In  einem  anderen  Modul  (Modul2)  kdnnte  die  Benutzung  so  aussehen: 

/xxiHni  M0DUL2.C 

♦include  <portab.h> 

EXTERN  WORD  gl.apid; 

VOID  test2  (x) 

WORD  x; 


WORD  apid; 
apid  = gl_apid; 


] /*  test2  */ 
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Wir  sehen,  dafi  die  Variable  einmal  normal  defmiert  ist  (sie  bekommt  dann  ihren  Spei- 
cherplatz  zugewiesen)  und  einmal  als  EXTERN,  ein  Bezeichner,  der  in  der  Datei  POR- 
TAB.H  als  „extem“  defmiert  ist,  d.h  durch  den  Befehl 

# define  EXTERN  extern 

Nun  tritt  folgendes  Problem  auf:  Wenn  die  Variable  ihren  Namen  (gl_apid)  oder  ihren 
Typ  (WORD)  andert,  so  muB  diese  Namensanderung  in  alien  Dateien,  die  diese  Variable 
benutzen,  ebenfalls  durchgefiihrt  werden,  und  zwar  in  der  Extern-Deklaration  und  im 
Programmcode.  Dies  gilt  natiirlich  fiir  alle  Variablen,  das  konnen  durchaus  einige 
Dutzend  sein. 

Wir  trennen  nun  zunachst  die  Definition  der  Variablen,  Konstanten  und  Typen  von  der 
eigentlichen  Implementierung.  Dadurch  ergibt  sich  fiir  obiges  Beispiel  folgendes  Bild  fiir 
Moduli: 

MODULI. H *»»»»/ 

WORD  gl_apld; 

/»*»*»  MODULI. C »»»»*/ 

# include  <portab.h> 

# include  "moduli. h" 

WORD  wert; 

LOCAL  VOID  testl  () 

( 

gl_apid  = appLlnit  ( ) ; 
wert  = 5; 

) /*  testl  */ 

Fiir  Modul2  benotigen  wir  momentan  nur  die  C-Datei: 

/*»»»»  M0DUL2.C  ***»*/ 

# include  <portab.h> 

# include  "moduli. h" 

VOID  test2  (x) 

WORD  x; 

[ 

WORD  apid; 
apid  = gl_apid; 

j /*  test2  */ 
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Der  Unterschied  zur  ersten  Ausfiihrung  besteht  nun  darin,  da6  die  Definition  von 
„gl_apid“  nur  noch  einmal  auftritt,  namlich  in  der  Headerdatei  MODUll.H.  Moduli 
hat  einen  „include“-Befehl,  urn  die  Definition  von  „gl  apid“  zu  kennen.  Das  gleiche 
gilt  fur  MODUL2.  Ganz  richtig  ist  die  zweite  Ausfiihrung  jedoch  nicht.  Denn  durch  die 
„include“-Anweisung  in  Modul2  wird  ebenfalls  Speicherplatz  fiir  „gl_apid“  belegt,  da 
diese  Definition  nicht  das  Schlusseiwort  „extern“  benutzt. 

Ein  Ausweg  aus  diesem  Dilemma  finden  wir,  indem  wir  Variablen  noch  ein  Schliissel- 
wort  voranstellen,  welches  von  beiden  Modulen  verschieden  interpretiert  wird.  Dieses 
Schlusseiwort  heilit  GLOBAL  und  wird  einmal  als 

#define  GLOBAL  EXTERN 

und  ein  anderes  Mai  als 

# define  GLOBAL 

definiert.  Diese  Definitionen  werden  in  einer  speziellen  Headerdatei  untergebracht.  Eine 
Datei  heiBt  „import.h“  und  benutzt  die  erste  Definition  (EXTERN),  die  andere  Datei 
heiflt  „export.h“  und  benutzt  die  zweite  Definition.  Unsere  Module  von  oben  haben  nun 
folgendes  Aussehen: 

/****»  MODULI. H **»*#/ 

GLOBAL  WORD  gl.apid; 

/*****  MODULI. C XXX**/ 

# include  <portab.h> 

# include  " export. h" 

# Include  "moduli. h" 

LOCAL  WORD  wert; 

LOCAL  VOID  testl  () 


gl.apid  = appl.init  (); 
went  = 5; 

) /*  testl  */ 


Fiir  Modul2  lautet  die  C-Datei : 
/xxxx*  M0DUL2.C  xxxxx/ 


# Include  <portab.h> 
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# include  "import. h" 
# include  "moduli. h" 

VOID  test2  (x) 

WORD  x; 


[ 

WORD  apid; 
apid  = gl_apid; 

] /*  testa  */ 

Wie  wir  nun  leicht  einsehen,  warden  von  Moduli  alle  Variablen,  die  sich  in  der  Datei 
MODULI. H befinden,  exportiert.  Durch  Benutzung  des  Befehls 

# include  ’’export. h” 

wird  die  Definition  von  GLOBAL  als  leer  angenommen,  woraus  sich  innerhalb  von 
MODULI. H ein 

WORD  gl_apid; 

ergibt.  Anders  sieht  es  bei  Modul2  aus.  Dort  wird  durch  Benutzung  des  Befehls 
#include  ’’import. h” 

die  Definition  von  GLOBAL  als  EXTERN  (=  extern)  angenommen,  woraus  sich  inner- 
halb von  MODULI. H ein 

EXTERN  WORD  gLapid; 

ergibt.  Dies  hat  nun  schon  eine  gewisse  Ahnlichkeit  mit  Modula-2,  wo  man  ja  auch  alle 
Funktionen,  Variablen  und  Typen,  die  man  in  einem  Modul  benutzen  mochte,  zuerst  im- 
portiert.  In  C entspricht  der  „IMPORT“-Befehl  von  Modula  nun  der  Einbindung  von 
„import.h“. 

Urn  Namensgleichheiten  beim  Linken  iiber  mehrere  Module  so  gering  wie  moglich  zu 
halten,  sollten  mdglichst  wenige  Bezeichner  jeweils  exportiert  werden.  Alle  Bezeichner, 
die  nur  innerhalb  eines  Moduls  benotigt  werden,  sollten  auch  nur  dort  definiert  sein.  Man 
erreicht  dies  durch  Voranstelien  des  Standard-C-Bezeichners  „ static".  Dieser  Bezeichner 
wird  auch  in  der  Datei  PORTAB.H  mittels 

# define  LOCAL  static 


und 


# define  MLOCAL  static 
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definiert.  Das  „M“  soli  fur  Modul  stehen.  Da  man  mit  „lokal“  aber  immer  lokal  zu  einem 
Modul  meint,  kann  man  das  „M“  auch  weglassen.  Man  hat  dann  die  beiden  Bezeichner 
„GLOBAL“  fur  globale  Vereinbarungen,  die  iiberall  sichtbar  sind,  und  „LOCAL“  fur 
lokale  Vereinbarungen,  die  nur  innerhalb  eines  Moduls  ihre  Gultigkeit  haben.  Der  groBe 
Vorteil  der  lokalen  Definitionen  besteht  darin,  daB  Bezeichner  in  verschiedenen  Modulen 
die  gleichen  Namen  haben  konnen,  da  der  Compiler  die  lokalen  Definitionen  vorzieht. 

Bevor  wir  unser  Beispiel  von  oben  erweitern,  wollen  wir  noch  das  eingangs  Gesagte  be- 
nutzen.  Demnach  besitzt  jedes  Modul  sowohl  eine  Schnittstellenbeschreibung  als  auch  ei- 
ne  Implementierung.  Die  beiden  Module  von  oben  und  das  „import.h“  sowie  „export.h“ 
haben  nun  folgende  Form: 

IMPORT. H tnixxx/ 

# include  <portab.h> 

# include  <aes.h> 

# include  <vdi.h> 

# define  GLOBAL  EXTERN 

/***»»  EXPORT. H *****/ 

#undef  GLOBAL 
# define  GLOBAL 

/***)(»  MODULI. H 

# define  MAX  10 

GLOBAL  WORD  array  [MAX] ; 

GLOBAL  WORD  gl.apid; 

/*»»**  MODULI. C »»***/ 

# include  "Import. h" 

# include  "export. h" 

# include  "moduli. h" 

LOCAL  WORD  wert; 

LOCAL  VOID  testl  _((V0ID)); 

LOCAL  VOID  testl  () 

[ 

gl.apid  = appl.inlt  (); 
wert  = 5; 

) /*  testl  */ 
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/***«»  H0DUL2.H 

GLOBAL  VOID  test2  .({WORD  x)); 

/***»*  M0DUL2.C  ****^/ 

# Include  "Import.h" 

♦include  "moduli. h" 

♦include  "export. h" 

♦include  "modul2.h" 

LOCAL  WORD  went; 

GLOBAL  VOID  test2  (x) 

WORD  x; 

[ 

WORD  apid,  i; 

went  = x; 
apid  = gl.apid; 
i =0; 

while  (i  < MAX)  array  [i++]  = x; 

] /*  test2  */ 

IMPORT. H und  EXPORT. H wurden  schon  oben  erklart.  In  IMPORT. H wurden  noch 
die  Dateien  „portab.h“,  „aes.h“  und  „vdi.h“  eingebunden. 

Jedes  Modul  besteht  nun  aus  den  zwei  Dateien,  die  jeweils  ein  Suffix  „H“  oder  „C“  tra- 
gen.  In  MODULI  .H  wird  die  Konstante  MAX  sowie  die  globalen  Variablen  „array“  und 
„gl_apid“  definiert.  Auf  diese  Bezeichner  kann  von  jedem  Modul  aus  zugegriffen  wer- 
den,  welches  diese  Datei  durch  den  entsprechenden  „include“-Befehl  importiert. 

MODULI. C beginnt  zunachst  mit  den  „include“-Anweisungen.  Zuerst  wird  die  Datei 
„import.h“  eingebunden.  Da  aber  nichts  importiert  wird,  folgt  nun  keine  weitere  Include- 
Datei.  Immerhin  konnen  wir  auch  auf  die  Einbindung  von  „portab.h“  verzichten,  da  wir 
diese  ins  „import.h“  verschoben  haben.  Danach  wird  die  Datei  „export.h“  eingebunden 
und  damit  die  eigene  Headerdatei  exportiert. 

Nach  den  „include“-Befehlen  werden  nun  die  Modul- internen,  d.h.  lokalen  Variablen 
aufgeftihrt.  Durch  das  Zusatzwort  LOCAL  (=  static)  wird  der  Bezeichner  (hier  „wert“) 
nicht  nach  auBen  getragen.  Damit  kann  in  anderen  Modulen  derselbe  Bezeichner  verwen- 
det  werden.  Es  konnte  immerhin  sein,  dali  ein  fremdes  Modul  dazugebunden  werden 
muB.  Da  man  moglicherweise  nicht  alle  Namen  aus  diesem  anderen  Modul  kennt,  ist  es 
besser,  wenn  jedes  Modul  so  wenig  Namen  wie  mdglich  nach  auBen  tragt. 
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Nach  der  Variablendefmition  werden  in  MODULI. C alle  Funktionen  aufgefuhrt,  die 
nicht  schon  in  der  Datei  MODULI. H aufgefuhrt  sind.  Es  kann  sich  daher  nur  um  die 
internen,  also  lokalen  Funktionen  handeln.  Im  Prinzip  ist  diese  Definition  nicht  so  wichtig 
— zumindest  bei  normalen  C-Compilern.  ANSI-Compilern  bietet  sie  jedoch  die  Moglich- 
keit,  sich  die  Prototypen  zu  merken  und  beim  Aufruf  (hier  von  „testl“)  die  Parameter 
zu  uberprufen.  Die  Definition  muB  sogar  erfolgen,  auch  wenn  der  Aufruf  von  „testl“ 
erst  auf  deren  Implementierung  folgt.  Der  Aufruf  ist  in  unserem  Beispiel  nicht  erfolgt, 
er  kdnnte  z.B.  weiter  unten  im  Modul  noch  auftreten. 

Die  Funktion  „testl“  ruft  nun  ihrerseits  die  Funktion  „appl_init“  auf.  Ihr  Prototyp  be- 
findet  sich  in  der  Datei  AES.H,  die  ja  ebenfalls  innerhalb  von  „import.h“  eingelesen 
wird.  Danach  wird  der  Variablen  „wert“  die  Konstante  30  (3  * MAX)  zugewiesen.  Sie 
behalt  ihren  Wert  und  wird  nicht  durch  eine  Zuweisung  an  eine  Variable  mit  gleichem 
Namen  in  Modul2  verandert.  Damit  endet  Moduli,  obwohl  naturlich  noch  mindestens 
ein  Aufruf  von  „testl“  erfolgen  sollte,  da  das  Modul  sonst  keine  sinnvolle  Aufgabe  hatte. 

Fur  Modul2  gilt  nun  Ahnliches  wie  fiir  Moduli . In  der  Datei  MODUL2.H  wird  die  Funk- 
tion „test2“  defmiert.  Damit  ist  ihr  Prototyp  bekannt  und  sie  kann  von  anderen  Modulen 
aufgerufen  werden,  wenn  diese  MODUL2.H  importieren,  Der  Prototyp  dient  aber  auch 
der  Implementierung  der  Funktion  in  der  Datei  MODUL2.C. 

In  MODUL2.C  werden  zuerst  alle  Dateien  angegeben,  die  importiert  werden  sollen.  Das 
bedeutet,  daB  nach  der  Angabe  von  „import.h“  nun  die  Datei  MODULI. H eingebunden 
wird.  Wir  erinnern  uns  daran,  daB  GLOBAL  auf  EXTERN  gesetzt  ist  und  somit  die  im- 
portierten  Variablen  keinen  zusatzlichen  Speicherplatz  bendtigen.  Durch  Einbinden  von 
„modull.h“  werden  also  die  Bezeichner  „MAX“,  „array“  und  „gl_apid“  bekannt. 
Diese  kdnnen  nun  nach  Belieben  benutzt  werden. 

Es  folgen  die  Include-Anweisungen  „export.h“  und  „modul2.h“.  Das  bedeutet,  daB  alle 
Defmitionen  von  MODUL2.H  anderen  Modulen  bekannt  gemacht  werden,  sofern  diese 
die  entsprechende  Datei  importieren. 

Danach  werden  auch  hier  alle  lokalen  Variablen  aufgefuhrt.  Die  Variable  „wert“  ist  hier 
nicht  gleichbedeutend  mit  der  Variablen  desselben  Namens  in  Moduli.  Das  liegt  daran, 
daB  sie  mittels  LOCAL  (=  static)  defmiert  wurde. 

Nun  kann  die  schon  in  der  Datei  MODUL2.H  aufgefiihrte  Funktion  „test2“  implemen- 
tiert  werden.  Der  Prototyp  existiert  schon  durch  Einbinden  der  Headerdatei  (s.o.).  Inner- 
halb der  Funktion  „test2“  werden  nun  der  Parameter  „x“,  die  globalen  Variablen 
„gl_apid“  und  „array“  (aus  Moduli)  sowie  die  Konstante  MAX  benutzt.  Damit  endet 
auch  Modul2.  Weitere  Funktionen  kdnnten  folgen. 

Wir  nehmen  nun  an,  daB  der  Typ  WORD  der  Komponenten  des  Feldes  „array“  nicht 
mehr  ausreicht  und  daB  dort  Langzahlen  gespeichert  werden  sollen.  Es  geniigt  nun,  in 
der  Datei  MODULI. H die  Definition 


6.2  Aufbau  und  Aufgaben  der  Module 


351 


GLOBAL  WORD  array  [MAX]; 

durch 

GLOBAL  LONG  array  [MAX]; 

zu  ersetzen.  An  der  Datei  MODUL2.C  muB  nun  keine  Anderung  vorgenommen  werden. 
Ein  erneutes  Ubersetzen  geniigt  hier  vollkommen,  es  sei  denn,  man  mochte  den  Typ  des 
Parameters  „x“  der  Funktion  „test2“  ebenfalls  auf  LONG  erweitern. 

So  wie  unser  Beispiel  untergliedern  wir  also  auch  unsere  Applikation  in  Module,  die  uber- 
schaubar  sind,  eine  abgegrenzte  Aufgabe  haben  und  moglichst  unabhangig  von  den  ande- 
ren  Modulen  sind.  Durch  die  moglichst  groBe  Unabhangigkeit  (nur  wenige  Bezeichner 
importieren)  erreichen  wir  auch,  daB  bei  Anderung  der  Schnittstelle  eines  Moduls  nur 
die  betroffenen  Module  iibersetzt  werden  miissen. 

Wir  wollen  nun  erreichen,  dafi  die  Module,  die  wir  schreiben,  moglichst  die  gleiche 
Schnittstelle  haben.  So  konnen  wir  uns  leichter  in  die  Module  hineinversetzen  und  mussen 
auch  nicht  lange  iiberlegen,  welche  Module  wir  mit  welchen  Parametern  aufrufen.  Diese 
Grundfunktionen  soil  jedes  Modul  zur  Verfugung  stellen.  Sie  konnen  jeweils  iiber  die 
Schnittstelle  aufgerufen  werden. 

Jedes  Modul  hat  einen  Namen.  Dies  ist  der  Name,  der  auch  als  Rumpf  fiir  den  Datei- 
namen  dient.  So  besteht  ein  Modul  mit  Namen  WINDOWS  aus  den  beiden  Dateien 
WINDOWS. H und  WINDOWS. C.  Der  Name  des  Moduls  wird  fiir  spezielle  Funktions- 
aufrufe  benutzt. 

Eine  oft  benotigte  Funktion  ist  das  Initialisieren  eines  Moduls.  Meistens  muB  dies  die  er- 
ste  Anweisung  sein,  die  in  einem  Modul  aufgerufen  werden  muB,  bevor  weitere  Funktio- 
nen  benutzt  werden  konnen.  Analog  dazu  kann  man  auch  fordem,  daB  ein  Modul  termi- 
niert  werden  muB,  bevor  ein  Programm  endgultig  verlassen  wird. 

Aus  diesem  Grund  fiihren  wir  zwei  Funktionen  ein,  die  ein  Modul  immer  haben  sollte: 
das  Initialisieren  und  das  Terminieren.  Zusammen  mit  dem  Namen  des  Moduls  sollen 
somit  die  Funktionen  „init_module“  und  „term_module“  zur  Verfugung  stehen.  Fiir 
ein  Modul  mit  Namen  WINDOWS  waren  dies  also  die  Funktionen  „init_windows“  und 
„term_windows“ . Meistens  kann  man  auf  Parameter  verzichten.  In  unserer  Beispiel- 
applikation  haben  nur  zwei  Module  Parameter  bei  den  Init- Aufrufen.  Die  Funktionen  sind 
also  immer  in  der  entsprechenden  Headerdatei  zu  finden. 

Vier  weitere  „Grundfunktionen“  sollen  fur  spezielle  Dialogmodule  zur  Verfugung  ge- 
stellt  werden.  Wir  sprechen  von  Dialogmodule,  wenn  es  sich  um  Module  handelt,  die 
Objekte  darstellen,  die  mit  dem  Benutzer  interagieren.  Dies  umso  mehr,  wenn  es  sich 
um  fenstererzeugende  Module  handelt,  d.h.  um  Module,  die  in  irgendeiner  Art  Fenster 
offnen  konnen.  Es  kann  sich  aber  auch  nur  um  Module  handeln,  die  eine  Art  von  Pikto- 
gramm  verwalten,  wie  Diskette,  Drucker  oder  Klemmbrett. 
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Fiir  diese  Art  von  Modulen  sollten  mindestens  die  folgenden  Funktionen  zur  Verfugung 
stehen,  die  fiir  jedes  Modul  die  gleichen  Parameter  besitzt.  Die  Funktionen  werden  hier 
nur  kurz  erlautert,  eine  ausfiihrliche  Erklarung  mit  vielen  Beispielen  folgt  in  den  weiteren 
Kapiteln. 

— Kreieren  eines  Fensters 
GLOBAL  WINDOW?  crt_module  (...); 

— Offnen  eines  Fensters  (oder  einer  Dialogbox  etc.) 

GLOBAL  BOOLEAN  open_module  (...); 

- Information  eines  Fensters 
GLOBAL  BOOLEAN  info_module  (...); 

- Hilfe  eines  Fensters  (...); 

GLOBAL  BOOLEAN  help_module  (...); 

Statt  „module“  muB  nun  jeweils  der  Name  eingesetzt  werden,  also  z.B.  „crt_meta“, 
„open_meta“  usw.  fur  das  Modul  META  (Metadatei-Verwaltung). 

Somit  haben  wir  sechs  Funktionen,  die  in  diesen  Modulen  immer  die  gleiche  Wirkung 
haben.  Dadurch  werden  wir  spater  aufs  leichteste  Menus  implementieren  konnen,  die  die 
Funktionen  „6ffnen“,  „Info“  und  „FIilfe“  beinhalten. 

Im  folgenden  soil  eine  Kurziibersicht  tiber  die  einzelnen  Module  gegeben  werden,  die 
dann  in  Abschnitt  6.5  genauestens  erklart  werden.  Abbildung  6.2  zeigt  einen  Uberblick. 


6.2  Aufbau  und  Aufgaben  der  Module 


353 


Dabei  bedeuten  die  Pfeile,  daB  ein  Modul  eine  Funktion  eines  anderen  Moduls  aufruft. 
Der  Ubersicht  halber  wurden  nicht  alle  Pfeile  eingetragen.  Vom  Modul  INITERM  wird 
jedes  Modul  mindestens  zweimal  aufgerufen,  einmal  zum  initialisieren,  einmal  zum  ter- 
minieren. 

Umgekehrt  wird  das  Modul  GLOBAL  von  fast  alien  anderen  Modulen  aufgerufen.  Auch 
das  Modul  WINDOWS  wird  auBer  von  EVENT  auch  von  einigen  anderen  Modulen  auf- 
gerufen. 

Wir  unterscheiden  noch  zwischen  programmabhangigen  und  -unabhangigen  Modulen. 
Einige  Module  wurden  so  konzipiert,  daB  sie  in  jeder  Applikation  verwendet  werden  kdn- 
nen,  ohne  daB  dabei  etwas  umgeschrieben  werden  muB,  ahnlich  wie  die  Funktionen  in 
der  Standard-C-Bibliothek.  Zu  den  programmunabhangigen  Modulen  gehoren  GLOBAL, 
WINDOWS  und  RCM.  In  gewissem  Sinne  zahlen  dazu  aber  auch  noch  GEMAIN  und 
EVENT. 


Die  Module  haben  im  einzelnen  folgende  Aufgaben: 

- GEMAIN 

GEM-unabhangiges  Hauptprogramm  fiir  alle  GEM-Versionen. 

- GLOBAL 

Globale  Vereinbarungen  fur  alle  GEM-Applikationen.  Dazu  zahlen  immer  wiederkehren- 
de  Konstanten  (z.B.  ASCII- Zeichen),  Typen  (z.B.  Zeichenketten,  Mengen)  und  Varia- 
blen  (z.B.  Applikationsnummer,  GEM-Arrays,  globale  Zeichensatz-  und  Desktop- 
GroBen). 

Eine  Menge  von  niitzlichen  Funktionen  sind  ebenfalls  vorhanden.  Mausfunktionen,  Ob- 
jektfunktionen,  Dialogfunktionen  inklusive  Pop-Up-Meniis  und  Verwaltung  von  Menii- 
tastenkiirzeln,  Rechteckfunktionen,  Speicherfunktionen,  Mengenfunktionen,  Dateifunk- 
tionen. 

Dazu  bietet  das  Benutzen  dieses  Moduls  die  Garantie  fiir  Kompatibilitat  mit  alien  GEM- 
Versionen, 

- WINDOWS 

GEM-iibergeordneter  Window-Manager,  der  Fenster  mit  verschiedenen  Inhalten  verwal- 
tet.  Neben  wichtigen  Konstanten  und  Typen  (allgemeiner  Fenstertyp)  gibt  es  eine  Menge 
Funktionen  zum  Verwalten  von  Fenstern.  Fenster-Suchfunktionen,  automatische  Schie- 
berverwaltung,  automatische  Objektverwaltung  innerhalb  eines  Fensters,  Funktionen  zur 
vereinfachten  Verwaltung  des  Fensterinnern  und  Meniiverwaltung  fiir  Meniizeilen  in 
Fenstern. 
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- RCM 

Das  Resource-Create-Modul  wurde  schon  in  Kapitel  2 angesprochen  und  dient  dazu, 
Resource-Dateien  in  C einzubinden,  damit  diese  nicht  mehr  geladen  werden  miissen.  In- 
teressant  ist  dies  vor  allem  fiir  Accessories.  So  hat  z.B.  das  Kontrollfeld  keine 
Resource-Datei. 

- EVENT 

Der  Event-Manager  verwaltet  alle  auftretenden  Ereignisse  und  leitet  sie  an  die  anderen 
Module  weiter.  Zu  den  Ereignissen  gehoren  Tastaturereignisse,  Mausknopfereignisse, 
Mausbewegungsereignisse  fur  verschiedene  Mausformen,  Nachrichtenereignisse  (Me- 
ntis, Fensternachrichten)  und  Zeitereignisse  fiir  Multitasking. 

- INITERM 

Alle  Module  werden  von  INITERM  initialisiert  und  am  Ende  terminiert. 

- RESOURCE 

Resource- Verwaltung  mit  und  ohne  explizite  Resource-Datei,  benutzerdefinierte  Objek- 
te,  Transformieren  von  Icons  und  Bit-Images. 

- MENU 

Die  Menuverwaltung  fiir  die  globale  Meniizeile. 

- DESKTOP 

Beispiel  fur  einen  eigenen  Desktop  mit  einigen  Piktogrammen. 

- CLIPBRD 

Das  Modul  verwaltet  das  Klemmbrett.  In  ihm  sind  auch  Funktionen  zu  finden,  welche 
die  fehlenden  Scrap-Funktionen  aus  GEM/3  im  alten  GEM  nachbildet. 

- DISK 

Verwaltung  des  Disk-Piktogramms  im  Desktop. 

- PRINTER 

Verwaltung  des  Drucker-Piktogramms  im  Desktop. 

- TRASH 

Verwaltung  des  Miilleimers,  der  auch  als  Fenster  geoffnet  werden  kann. 
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- IMAGE 

Darstellung  von  Bit-Image-Dateien  in  einem  Fenster. 

- META 

Darstellung  von  Metadateien  in  einem  Fenster. 

- EDIT 

Darstellung  von  Dateien  (ASCII-Textdateien)  in  einem  Fenster. 

- POWER 

Beispielmodul  fiir  die  Darstellung  von  Potenzen  einer  Zahl  inklusive  Benutzung  von  Pop- 
Up-Meniis  in  einem  Fenster. 

- GRAF 

Beispielmodul  fur  die  Darstellung  einer  Grafik  inklusive  Multitasking-Benutzung. 

Die  Aufrufreihenfolge  der  Module  ist  von  groBer  Wichtigkeit.  Ein  Modul  muB  zunachst 
initialisiert  werden,  bevor  man  seine  Funktionen  aufrufen  kann. 

Beim  Start  eines  Programms  wird  zunachst  GEM  AIN  aufgerufen.  Dort  wird  das  Modul 
INITERM  angesprungen  und  alle  Module  initialisiert.  Dann  wird  ins  EVENT-Modul  ver- 
zweigt  und  auf  Ereignisse  gewartet.  Tritt  ein  Meniiereignis  auf,  so  wird  ins  Modul 
MENU  verzweigt,  und  von  dort  werden  die  entsprechenden  Funktionen  aufgerufen,  wie 
z.B.  „open_graf“,  um  ein  Grafikfenster  zu  offnen. 

Bei  Fensterereignissen  wird  uber  WINDOWS  in  das  jeweilige  Modul  verzweigt.  Falls 
dies  der  Desktop  ist,  wird  von  ihm  die  entsprechende  Icon-Funktion  fur  CLIPBRD, 
DISK,  PRINTER  oder  TRASH  aufgerufen.  Uber  CLIPBRD  konnen  wiederum  Bit- 
Image-Dateien,  Metadateien  und  Textdateien  aufgerufen  werden. 


6.3  Allgemeine  Fensterverwaltung 

Fiir  die  Verwaltung  von  Fenstern  in  einer  grafischen  Benutzeroberflache  muB  immer  ein 
groBerer  Aufwand  getrieben  werden,  als  fur  die  Verwaltung  von  einfachen  Dialogen.  Der 
Grund  ist  darin  zu  suchen,  daB  ein  Fenster,  einmal  gedffnet,  solange  lebt,  bis  es  wieder 
geschlossen  wird.  Da  dies  fiir  mehrere  Fenster  gleichzeitig  gilt,  miissen  alle  Informatio- 
nen  fiir  die  Fenster  immer  zugriffsbereit  sein.  Ein  Fenster  sieht  dann  wie  ein  ProzeB  aus, 
der  seine  eigenen  Informationen  verwaltet,  die  von  den  anderen  Fenstern  unabhangig 
sind.  Da  Fenster  in  der  Regel  verschiedene  Informationen  anzeigen,  miissen  Algorithmen 
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angewandt  werden,  die  abhangig  vom  jeweiligen  Fenster  den  aktuellen  Stand  der  Infor- 
mation anzeigen. 

Bevor  wir  naher  auf  die  Verwaltung  verschiedener  Fensterinhalte  eingehen,  wollen  wir 
uns  zunachst  ein  Fenster  genauer  betrachten.  Abbildung  6.3  zeigt  ein  Fenster  des 
Resource-Construction-Sets  von  Digital  Research. 
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Abbildung  6.3:  Fenster  im  Resource-Construction-Set. 


An  diesem  Fenster  werden  Methoden  benutzt,  die  auf  den  ersten  Blick  nicht  auffallen. 
Das  Fenster  zeigt  am  linken  Rand  eine  Leiste  mit  Tools,  die  mit  dem  Befehl  „Hide  Tools" 
versteckt  werden  kann.  Am  unteren  Rand  wird  eine  Leiste  mit  Teilen  gezeigt,  die  mit 
dem  Befehl  „Hide  Parts"  versteckt  werden  kann. 

Der  Rest  des  Fensters  ist  der  Bereich,  der  die  eigentliche  Information  anzeigt.  Dies  ist 
auch  der  Bereich,  der  gescrollt  werden  kann  und  der  fur  die  Berechnung  der  Schieber 
relevant  ist.  Wenn  das  Fenster  gescrollt  wird,  so  bleiben  der  iinke  und  untere  Rand  also 
erhalten.  Man  konnte  sich  auBerdem  vorstellen,  einen  oberen  und  einen  rechten  Rand  zu 
haben.  Am  oberen  Rand  konnten  dann  z.B.  eine  Meniizeile  dargestellt  werden  und  am 
rechten  Rand  weitere  Bedienungselemente,  wie  das  z.B.  im  Programm  GEMPAINT  von 
Digital  Research  der  Fall  ist. 

Da  der  Programmierer  fur  das  gesamte  Innere  des  Fensters  verantwortlich  ist,  der  Be- 
reich, der  gescrollt  werden  kann,  jedoch  manchmal  auch  kleiner  ausfallt,  wollen  wir  das 
Fensterinnere  noch  einmal  unterteilen.  In  Abbildung  6.4  wird  ein  Fenster  gezeigt,  wel- 
ches samtiiche  Komponenten  enthalt. 
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Abbildung  6.4:  Allgemeiner  Aufbau  eines  Fensters 

Wir  erkennen  folgendes:  Zunachst  existiert  der  Fensterrandbereich.  Welche  Komponen- 
ten  er  erhalt,  tnuB  beim  Erzeugen  des  Fensters  angegeben  werden.  Das  Fensterinnere 
nennen  wir  den  Arbeitsbereieh  (Workbereich) . Fiir  diesen  ist  der  Programmierer  verant- 
wortlich.  Innerhalb  des  Arbeitsbereichs  liegt  die  eigentliche  Information,  d.h.  der  Teil 
eines  Dokuments,  dutch  den  gescrollt  werden  kann  und  fur  den  die  Schieber  die  relative 
Grohe  anzeigen.  Wir  nennen  ihn  deshalb  auch  Scrollbereich. 

Der  Scrollbereich  mull  nicht  kleiner  sein  als  der  Arbeitsbereieh.  Falls  keine  zusatzlichen 
Komponenten  wie  in  Abbildung  6.3  benotigt  werden,  entfallt  die  Unterscheidung  zwi- 
schen  Arbeitsbereieh  und  Scrollbereich  — sie  sind  identisch. 

Man  hat  nun  die  Moglichkeit,  den  oberen  Rand  (top),  den  linken  Rand  (left),  den  unteren 
Rand  (bottom)  und  den  rechten  Rand  (right)  zu  belegen  (oder  nur  einen  Teil  der  Rander). 
Beim  Scrollen  werden  dann  die  Rander  beriicksichtigt  und  nicht  mitgescrollt.  Sie  bleiben 
ergo  erhalten. 

Das  hier  beschriebene  Modul  WINDOWS  beriicksichtigt  eine  Menge  von  Formen  von 
Fenstern,  die  schon  in  verschiedenen  bekannten  Programmen  aufgetreten  sind,  und  ver- 
sucht,  einfache  Hilfsmittel  zur  Verfiigung  zu  stellen,  um  alle  diese  Formen  zu  unter- 
stiitzen. 

Dafiir  wird  eine  Struktur  zur  Verfiigung  gestellt,  die  mit  einem  Fenster  verbunden  ist. 
Diese  Struktur  ist  in  der  Datei  WINDOWS. FI  definiert  und  hat  den  Namen  WINDOW. 
Ein  Zeiger  (Pointer)  auf  eine  solche  Struktur  ist  (als  WINDOWP)  definiert. 


Diese  Struktur  sollte  man  verstanden  haben,  da  sie  als  Parameter  an  fast  alle  Funktionen 
des  Window-Managers  iibergeben  wird.  Bevor  die  Struktur  genauer  erlautert  wird,  mu6 
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aber  noch  ein  Konzept  vorgestellt  werden,  welches  fur  das  Verstehen  unabdingbar  ist. 
Es  handelt  sich  um  das  Konzept  der  indirekten  Funktionen,  welches  nur  in  modemen 
hoheren  Programmiersprachen  verfiigbar  ist.  So  kann  man  diese  in  C oder  Modula-2  defi- 
nieren.  Sprachen  wie  Basic  sind  dabei  selbstverstandlich  ausgeklammert. 


Fast  jeder  von  uns  kennt  den  Aufruf  einer  Funktion  von  irgendeiner  Stelle  eines  Pro- 
gramms  aus.  Beispiel: 


# include  <portab.h> 

# include  <math.h> 

GLOBAL  DOUBLE  berechne  (x,  y) 

DOUBLE  X,  y; 

[ 

DOUBLE  res,  d; 
d = sin  (x); 

/*  Benutzung  von  d fiir  weitere  Berechnungen  */ 
d = 3 » sin  (y  + 1.1) ; 

/*  Benutzung  von  d ftir  weitere  Berechnungen  */ 

/»  ...  V 

return  (res); 

] 


Ein  Aufruf  von  „berechne“  konnte  dann  als 
berechne  (3.0,  5.1); 
geschrieben  werden. 


In  der  Funktion  „berechne“  wird  die  Funktion  „sinus“  aufgerufen,  deren  Definition  sich 
in  der  Datei  „math.h“  befindet.  Dies  ist  eine  Moglichkeit,  die  Sinusfunktion  aufzurufen. 
Sie  wird  hier  zweimal  aufgerufen,  man  konnte  sich  auch  noch  weitere  Aufrufe  vorstellen. 
Dieselben  Berechnungen  sollen  jetzt  fiir  den  Cosinus  gemacht  werden.  Dabei  miiBte  man 
iiberall,  wo  „sin“  steht,  das  Wort  „cos“  einsetzen.  Die  Funktion  kann  dann  aber  nicht 
mehr  fur  die  Berechnung  iiber  den  Sinus  verwendet  werden. 

Eine  Moglichkeit  besteht  nun  darin,  an  die  Funktion  „berechne“  eine  Zahl  mitzuliefern, 
welche  die  Funktion  angibt  und  innerhalb  von  „berechne“  mit  Hilfe  von  „switch“  ent- 
sprechend  zu  verzweigen. 
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Die  Implementierung  wiirde  dann  z.B.  aussehen: 

GLOBAL  DOUBLE  berechne  (func,  x,  y) 

WORD  func; 

DOUBLE  X,  y; 


DOUBLE  res,  d; 

switch  (func) 

case  0 : d = sin  (x); 

case  1 : d = cos  (x); 

) 

/*  Benutzung  von  d fUr  weitere  Berechnungen  */ 
switch  (func) 

( 

case  0 : d = 3 * sin  (y  + l.l); 

case  1 : d = 3 * cos  (y  + 1.1); 


/*  Benutzung  von  d fiir  weitere  Berechnungen  */ 
/»  ...  V 
return  (res); 


Ein  Aufruf  lautet  dann 
berechne  (0,  3.0,  5.1) 
fur  den  Sinus  und 
berechne  (1,  3.0,  5.1) 
fur  den  Cosinus. 

Wir  sehen  ganz  deutlich  die  Schwache  dieser  Implementierung.  Fiir  jede  Funktion  mu6 
in  einem  „switch“-Befehl  ein  Fall  vorgesehen  werden.  Noch  schlimmer;  Da  die  Funktion 
einige  Male  benutzt  wird,  miissen  es  jeweils  mehrere  „switch“-Implementierungen  sein. 
Das  Problem  bei  dieser  Implementierung  ist  aber  nicht  nur  die  rasch  wachsende  Code- 
groBe  der  Funktion  „berechne“,  sondern  auch  das  Fehlen  weiterer  Funktionen.  Fiir  die 
gleiche  Berechnung  mit  Hilfe  des  Tangens  ist  die  Funktion  so  nicht  vorgesehen.  Wun- 
schenswert  ware  eine  Implementierung,  die  es  erlaubt,  innerhalb  von  „berechne“  die 
Funktion  aufzurufen,  die  gerade  benotigt  wird,  ohne  daB  dort  die  Funktion  zur  Uber- 
setzungszeit  selbst  bekannt  ist. 
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Dies  geht  nur  mit  dem  Prinzip  des  indirekten  Funktionsaufrufs.  Die  Funktion,  die  ausge- 
fuhrt  werden  soli,  wird  dann  als  Parameter  an  „berechne“  iibergeben.  Die  Definition 
sieht  nun  wieder  einfacher  aus: 

GLOBAL  DOUBLE  berechne  (func,  x,  y) 

DOUBLE  (*func)  .((DOUBLE  x)); 

DOUBLE  X,  y; 

( 

DOUBLE  res,  d; 
d = (»func)  (x); 

/*  Benutzung  von  d fiir  weltere  Berechnungen  */ 
d = 3 * (*func)  (y  + 1.1); 

/*  Benutzung  von  d fiir  weltere  Berechnungen  */ 

/*  ...  V 
return  (res); 

) 


Ein  Aufruf  von  „berechne“  sieht  nun  folgendermaBen  aus: 
berechne  (sin,  3.0,  5.1); 

Oder 

berechne  (cos,  3.0,  5.1) 

Es  hindert  uns  allerdings  auch  niemand  daran,  die  Funktion  „berechne“  als 
berechne  (tan,  3.0,  5.1); 

Oder 

berechne  (atan,  3.0,  5.1); 

aufzurufen.  Lediglich  ein  Aufruf  von  z.B. 

berechne  (fmod,  3.0,  5.1); 

wiirde  nicht  funktionieren.  Die  Modulo-Funktion  „fmod“  erwartet  namlich  zwei  Parame- 
ter, nicht  nur  einen  wie  etwa  Sinus  und  Cosinus.  Da  die  Funktion  „func“  in  „berechne“ 
aber  nur  jeweils  mit  einem  Parameter  aufgerufen  wird,  wiirde  an  „fmod“  nur  ein  Parame- 
ter ubergeben  werden,  was  in  diesem  Fall  falsch  ist.  Der  Aufruf  indirekter  Funktionen 
(func)  klappt  also  nur,  wenn  die  Anzahl,  die  Reihenfolge  und  der  Typ  der  Parameter  uber- 
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einstimmt.  Ahnliches  gilt  fiir  das  Funktionsergebnis.  Bei  einem  ANSI-Compiler  wiirde 
der  letzte  „berechne“-Aufruf  nicht  angenommen  werden.  Es  wiirde  eine  Fehlermeldung 
geliefert  und  erst  gar  kein  Code  erzeugt  werden.  Bei  anderen  Compilern  wiirde  das  Pro- 
gramm  zur  Laufzeit  merkwiirdige  Ergebnisse  bringen.  Das  ist  ein  Grund  mehr,  einen 
ANSI-C-Compiler  zu  benutzen. 


Wir  haben  nun  gesehen,  wie  man  mit  Hilfe  indirekter  Funktionsaufrufe  eine  Routine 
schreiben  kann,  die  noch  nicht  weiB,  welche  Funktion  letztendlich  aufgerufen  wird.  Diese 
wird  durch  den  Ubergabeparameter  „func“  beschrieben. 


Genauso  kann  man  aber  auch  Variablen  definieren,  die  Zeiger  auf  Funktionen  enthalten 
und  diese  Variablen  statt  der  eigentlichen  Funktion  aufrufen.  Insbesondere  konnen  meh- 
rere  dieser  Funktionen  (Variablen)  in  einer  Struktur  zusammengefaBt  werden.  In  folgen- 
dem  Beispiel  sollen  viele  Funktionen  an  eine  Routine  iibergeben  werden.  Da  man  die  An- 
zahl  der  Parameter  aber  gering  halten  mochte,  werden  die  Funktionen  erst  einmal  in  einer 
Struktur  gespeichert  und  von  der  ausfiihrenden  Routine  dann  aufgerufen. 


# include  <portab.h> 
# Include  <math.h> 


typedef  struct 


DOUBLE  (*funcl)  .((DOUBLE 
DOUBLE  (*func2)  .((DOUBLE 
DOUBLE  (»func3)  .((DOUBLE 
DOUBLE  (*func4)  .((DOUBLE 
) FUNCS; 


x)); 

x)); 

x)); 

X,  DOUBLE  y)); 


GLOBAL  DOUBLE  berechne  (funcs,  x,  y) 
FUNCS  *funcs; 

DOUBLE  X,  y; 


DOUBLE  res,  d; 


d = (*funcs->funcl)  (x) ; 

/*  Benutzung  von  d fiir  weitere  Berechnungen  */ 
d = 3 * (*funcs->func4)  (x,  y + l.l); 

/*  Benutzung  von  d fiir  weitere  Berechnungen  */ 
/*  ...  */ 
return  (res); 
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Zunachst  muB  nun  eine  Struktur  vorliegen,  welche  initialisiert  wird.  Diese  wird  dann  an 
die  Funktion  „berechne“  iibergeben.  Also: 


( 

FUNCS  funcs; 

funcs.funcl  = sin; 
funcs. func2  = cos; 
funcs.func3  = tan; 
funcs. func4  = fmod; 


berechne  (&funcs,  13.7,  5.91); 

] 


In  diesem  Beispiel  warden  den  verschiedenen  Variablen  innerhalb  der  Struktur  „funcs“ 
zuerst  Werte  fiir  die  Funktionen  zugewiesen.  Man  beachte,  dafi  fiir  func4  eine  Funktion 
gewahlt  werden  muB,  welche  zwei  Parameter  erwartet,  also  z.B.  „fmod“.  Ansonsten  ist 
das  Prinzip  das  gleiche  wie  oben.  Der  Vorteil  liegt  in  der  besseren  Ubersicht  der  Funktion 
„berechne“,  da  diese  nun  immer  nur  drei  Parameter  zu  haben  braucht,  auch  wenn  noch 
weitere  Funktionen  in  der  Struktur  FUNCS  dazukommen  wiirden. 

Wir  fassen  zusammen:  Eine  Funktion  muB  nicht  notwendigerweise  direkt  aufgerufen 
werden.  Ein  indirekter  Aufruf  (iiber  den  Zeiger)  einer  Funktion  hat  den  Vorteil,  unabhan- 
gig  von  der  eigentlichen  Funktion  zu  sein,  die  beim  Aufruf  dahintersteckt.  Routinen,  die 
allgemein  geschrieben  werden  mussen,  aber  mit  verschiedenen  Funktionen  auf  die  glei- 
che Art  zu  arbeiten  haben,  konnen  mit  dem  Prinzip  des  indirekten  Aufrufs  implementiert 
werden. 


Beispiele  fur  Aufrufe  mit  indirekten  Funktionen  sind  auch  in  vielen  Compiler- 
Bibliotheken  enthalten.  So  existiert  z.B.  eine  Funktion  „qsort“,  welche  den  Quicksort- 
Algorithmus  auf  ein  Feld  von  Elementen  anwendet.  Da  aber  die  Komponenten  des  Feldes 
verschiedener  Art  sein  konnen  (Ganzzahlen,  FlieBkommazahlen,  Zeichenketten  etc), 
kann  die  Funktion  „qsort“  nicht  den  Vergleich  von  zwei  Komponenten  durchfiihren.  Sie 
benotigt  dann  einen  Zeiger  auf  eine  Funktion,  die  diesen  Vergleich  durchfuhrt.  Der  Auf- 
rufer  kann  nun  je  nach  Art  der  Elemente  verschiedene  Funktionen  an  „qsort“  iibergeben, 
z.B.  „strcmp“,  um  Zeichenketten  zu  vergleichen  oder  „longcmp“,  um  lange  Ganzzahlen 
zu  vergleichen. 


Doch  nun  zuriick  zu  unserer  Struktur  WINDOW  in  WINDOWS. H.  Sie  besteht  aus  41 
Variablen,  21  gewohnlichen  Variablen  und  20  Zeigern  auf  Funktionen.  Jede  Variable 
Oder  Funktion  hat  eine  wichtige  Bedeutung,  die  nun  beschrieben  werden  soli. 
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typedef  struct  window 

{ 

WORD  handle ; 

WORD  opened; 

DWORD  flags; 

DWORD  kind; 

WORD  class; 

WORD  icon; 

LRECT  doc; 

WORD  xfac; 

WORD  yfac; 

RECT  scroll; 

RECT  work; 

WORD  mousenum; 

MFORM  »mouseforra; 

LONG  milli; 

LONG  count; 

LONG  special; 

STRING  name; 

STRING  info; 

OBJECT  ^object; 

OBJECT  »menu; 

WORD  flrst_raenu; 

VOID  (»updt_menu)  _( (WINDOWP  window) ) ; 

VOID  (»hndl_menu)  _( (WINDOW?  window,  WORD  title,  WORD  item)); 
BOOLEAN  (»test)  _( (WINDOW?  window,  WORD  action)); 

VOID  (»open)  _( (WINDOW?  window)); 

VOID  (»close)  _( (WINDOW?  window) h 

VOID  (^delete)  _( (WINDOW?  window)); 

VOID  (*draw)  .((WINDOW?  window)); 

VOID  (Harrow)  .((WINDOW?  window,  WORD  dir, 

LONG  oldpos,  LONG  newpos)); 

VOID  (»snap)  .((WINDOW?  window,  RECT  *new,  WORD  mode)); 

VOID  (*objop)  .((WINDOW?  window,  SET  objs,  WORD  action)); 

WORD  (*drag)  .((WINDOW?  src.wlndow,  WORD  src.obj , 

WINDOW?  dest.window,  WORD  dest.obj)); 
VOID  (»click)  .((WINDOW?  window,  MKINFO  *mk)); 

VOID  (*unclick)  .((WINDOW?  window)); 

BOOLEAN  (*key)  .((WINDOW?  window,  MKINFO  *rak)); 

VOID  (»timer)  .((WINDOW?  window)); 

VOID  (»top)  .((WINDOW?  window)); 

VOID  (*untop)  .((WINDOW?  window)); 

VOID  (*edit)  .((WINDOW?  window,  WORD  action)); 

BOOLEAN  (*showlnfo)  .((WINDOW?  window,  WORD  icon)); 

BOOLEAN  (»showhelp)  .((WINDOW?  window,  WORD  icon)); 

) WINDOW; 
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WORD  handle; 

Das  GEM-Handle  fur  ein  Fenster.  Es  wird  vor  allem  fiir  die  Aufrufe  der  AES-Window- 
Bibliothek  verwendet.  Wenn  ein  Fenster  nicht  offen  ist,  so  hat  „handle“  den  Wert  - 1, 


WORD  opened; 

Gibt  an,  wie  oft  ein  Fenster  gebffnet  wurde.  Das  Fenster  muB  dann  genauso  oft  geschlos- 
sen  werden,  wie  es  geoffnet  wurde.  Beim  Anwahlen  der  SchlieBbox  eines  Fensters  muB 
das  Fenster  nicht  notwendigerweise  wirklich  geschlossen  werden.  Es  kann  auch  sein,  daB 
man  in  einer  Hierarchie  nur  um  eine  Stufe  zuruckfiillt.  Bestes  Beipiel  ist  der  GEM- 
Desktop.  Wird  in  einem  geoffneten  Fenster  ein  Ordner  angewahlt,  so  offnet  sich  dieser 
und  das  Fenster  zeigt  den  neuen  Inhalt.  Dabei  wird  aber  kein  wirklich  neues  Fenster  ge- 
bffnet, wie  das  z.B.  beim  Finder  des  Macintosh  der  Fall  ist.  Stattdessen  wird  das  alte 
Fenster  benutzt.  Wird  nun  auf  die  SchlieBbox  geklickt,  so  soil  das  Fenster  nicht  geschlos- 
sen werden,  da  man  nur  in  der  Ordnerhierarchie  um  eine  Stufe  zuriickgeht. 


DWORD  flags; 

Dies  sind  verschiedene  Flags,  welche  die  Applikation  beim  Kreieren  eines  Fensters  setzen 
kann,  um  das  Verhalten  des  Window-Managers  zu  beeinflussen.  Die  Flags  kbnnen  sein 
(siehe  WINDOWS.  H): 

WI  NONE:  Keine  Flags 

WLFULLED:  Das  Fenster  ist  auf  voller  GrbBe. 

WI_ONTOP:  Das  Fenster  befindet  sich  ganz  oben. 

WI_RESIDENT : Position  und  GrbBe  sollen  beim  SchlieBen  des  Fensters  erhalten  blei- 
ben.  Das  bedeutet,  daB  beim  erneuten  Offnen  des  Fensters  dieses  an  der  alten  Stelle  mit 
der  alten  GrbBe  auftaucht.  Dieses  wird  besonders  gern  benutzt,  wenn  Fenster  beim 
SchlieBen  in  Piktogramme  „verwandelt“  werden  und  durch  erneutes  Anklicken  der  Pikto- 
gramme  wieder  gebffnet  werden. 

WLMOUSE:  Das  Fenster  hat  eine  eigene  Mausform.  Der  Window-Manager  kann  zu- 
sammen  mit  dem  Event-Manager  fiir  jedes  Fenster  eine  eigene  Mausform  verwalten. 
Beim  Eintreten  in  den  Scrollbereich  wird  die  Mausform  umgeschaltet. 

WI_DIALOG:  Das  Fenster  zeigt  eine  „modeless“  Dialogbox.  Dies  ist  in  dieser  Version 
noch  nicht  implementiert,  jedoch  schon  vorgesehen. 


DWORD  kind; 

Dies  ist  die  Art  des  Fensters,  die  festlegt,  welche  Komponenten  ein  Fenster  haben  kann. 
Die  Komponeneten  sind  (siehe  AES.H)  Titelzeile,  Infozeile,  SchlieBbox,  Fullbox,  Ver- 
groBerungsbox  und  alle  Schieberelemente. 
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WORD  class; 

Daainter  verstehen  wird  die  Klasse  eines  Fensters.  Es  handelt  sich  hierbei  um  eine  einzig- 
artige  Identifikation  fiir  die  Beschreibung  des  Fensters.  Dabei  gehdren  Fenster,  die 
gleichartige  Inhalte  zeigen,  auch  in  die  gleiche  Klasse.  Beispielsweise  waren  alle  Fenster 
im  Programm  Wordplus  in  der  gleichen  Klasse,  da  sie  alle  Text  einer  Datei  zeigen.  Dage- 
gen  waren  die  Ausgabefenster  und  das  DB-Info-Fenster  von  ADIMENS  ST  in  verschiede- 
nen  Klassen,  da  sie  ganzlich  verschiedenartige  Inhalte  zeigen.  Bestimmte  Konstanten  fur 
Klassenidentifikation  sind  schon  reserviert.  Es  sind  dies  (siehe  GLOBAL. H) 

# define  DESK  0 

# define  DESKWINDOW  1 


DESK  gibt  das  Fenster  an,  welches  den  Desktop  beschreibt,  der  den  ganzen  Bildschirm 
ausfiillt.  DESKWINDOW  gibt  ebenfalls  den  Desktop  an,  der  sich  aber  nun  in  einem  Fen- 
ster befindet  (z.B.  fur  Accessories  oder  Multitasking  X/GEM). 


Alle  Zahlen  ab  2 aufwarts  konnen  nun  fiir  eigene  verschiedenartige  Klassen  von  Fenstern 
benutzt  werden.  Beispiele  finden  sich  in  alien  Modulen  von  SCRAP,  die  Fenster  erzeu- 
gen,  also  DESKTOP,  CLIPBRD,  TRASH,  IMAGE,  META,  EDIT,  POWER,  GRAF. 


WORD  icon; 

Es  handelt  sich  um  die  Objektnummer  des  Piktogramms,  aus  welchem  ein  Fenster  ent- 
standen  ist.  Falls  das  Fenster  nicht  aus  einem  Piktogramm  entstanden  ist,  kann  der  Wert 
auch  NIL  (=  -1)  annehmen.  Diese  Variable  wird  benutzt,  um  beim  Anklicken  eines  Pik- 
togramms das  dazugehdrige  Fenster  zu  suchen,  falls  bereits  eines  existiert.  Beispiele  sind 
in  SCRAP  in  alien  Modulen  zu  finden,  die  Fenster  durch  Anklicken  von  Piktogrammen 
offnen.  Weitere  bekannte  Beispiele  fiir  eine  sinnvolle  Anwendung  dieser  Variablen  sind 
der  GEM-Desktop  und  das  Textverarbeitungsprogramm  TEMPUS. 


LRECT  doc; 

Der  Datentyp  LRECT  ist  ein  Rechteck  aus  den  vier  Langzahlen  x,  y,  w und  h fiir  die 
X-Koordinate,  die  Y-Koordinate,  die  Breite  und  die  Hohe.  Somit  existieren  die  vier 
Variablen  doc.x,  doc.y,  doc.w  und  doc.h.  Die  beiden  ersten  Komponenten  geben  die  ab- 
solute X-  und  Y-Koordinate  innerhalb  des  Dokumentes  an,  welches  in  der  linken  oberen 
Ecke  des  Fensters  gezeigt  wird.  Die  beiden  anderen  Komponenten  geben  die  aktuelle 
Breite  und  Hohe  des  Dokumentes  an,  von  welchem  das  Fenster  einen  Ausschnitt  zeigt. 
Mit  Hilfe  dieser  Werte  kann  der  Window-Manager  jederzeit  die  aktuellen  Schieberposi- 
tionen  und  -groBen  berechnen. 
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Zur  Verdeutlichung  dient  die  Abbildung  6.5. 


•e 


doc.H  ° 

28 

doc.y  = 

58 

doc. Ill  » 

88 

doc.h  » 

188 

Abbildung  6.5:  Dokument  und  Fenster 


Jedes  Fenster  zeigt  einen  Ausschnitt  aus  einem  (meist  grofieren)  Dokument.  Zeigt  das 
Fenster  in  der  linken  oberen  Ecke  beispielsweise  die  50.  Zeile  und  20.  Spalte  eines  Doku- 
mentes  an,  welches  100  Zeilen  mit  jeweils  80  Spalten  besitzt,  so  sind  die  Werte  von 
„doc“: 

1 

doc.x  = 20; 

doc.y  = 50; 
doc.w  = 80; 
doc.h  = 100; 

Die  Zahlung  beginnt  dabei  jeweils  von  0.  Sind  alle  Werte  0,  so  mufi  das  Fenster  leer  sein, 
da  noch  kein  Dokument  existiert. 


WORD  xfac; 

Der  X-Faktor  gibt  an,  mit  welcher  Zahl  multipliziert  werden  muB,  wenn  in  horizontaler 
Richtung  urn  eine  Einheit  gescrollt  werden  soli.  Eine  Einheit  ist  minimal  1 Pixel.  Bei  vie- 
len  Programmen  bieten  sich  aber  groBere  Zahlen  an.  Wird  beispielsweise  in  einem  Fen- 
ster  Text  dargestellt,  so  sollte  „xfac“  z.B.  den  Wert  8 besitzen,  wenn  ein  Zeichen  8 Pixel 
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Breite  besitzt.  1st  ein  Zeichen  groBer  oder  kleiner,  kann  der  Wert  natiirlich  entsprechend 
angepafit  werden. 

Die  Komponenten  „doc.x“  und  „doc.w“  von  „doc“  (s.o.)  sind  Werte  in  dieser  Einheit. 
Es  ist  also  fur  „doc“  unwesentlich,  mit  welcher  Schriftart  der  Text  dargestellt  wird,  mafi- 
gebend  sind  die  Anzahl  der  Zeilen  und  Spalten  eines  Dokumentes  in  Einheiten. 


WORD  yfac; 

Der  Y-Faktor  gibt  an,  mit  welcher  Zahl  multipliziert  werden  muB,  wenn  in  vertikaler 
Richtung  um  eine  Einheit  gescrollt  werden  soli.  Eine  Einheit  ist  minimal  1 Pixel.  Bei  vie- 
len  Programmen  bieten  sich  aber  groBere  Zahlen  an.  Wird  beispielsweise  in  einem  Fen- 
ster  Text  dargestellt,  so  sollte  „yfac“  z.B.  den  Wert  16  besitzen,  wenn  ein  Zeichen  16 
Pixel  Hohe  besitzt.  Ist  ein  Zeichen  groBer  oder  kleiner,  kann  der  Wert  natiirlich  entspre- 
chend angepaBt  werden. 

Die  Komponenten  „doc.y“  und  „doc.h“  von  „doc“  (s.o.)  sind  Werte  in  dieser  Einheit. 
Es  ist  also  fur  „doc“  unwesentlich,  mit  welcher  Schriftart  der  Text  dargestellt  wird,  maB- 
gebend  sind  die  Anzahl  der  Zeilen  und  Spalten  eines  Dokuments  in  Einheiten. 

Werden  in  einem  Fenster  Piktogramme  dargestellt  (siehe  CLIPBRD),  so  sind  xfac  und 
yfac  die  Breite  und  Hohe  dieser  Piktogramme  in  Pixel. 


RECT  scroll; 

Der  Datentyp  RECT  ist  ein  Rechteck  aus  den  vier  Ganzzahlen  x,  y,  w und  h fiir  die  X- 
Koordinate,  die  Y-Koordinate,  die  Breite  und  die  Hohe.  Somit  existieren  die  vier  Varia- 
blen  scroll. X,  scroll. y,  scroll. w und  scroll. h.  Sie  geben  die  absolute  X-  und  Y-Koordinate 
sowie  Breite  und  Hohe  (in  Pixeln)  des  Scrollbereichs  des  Fensters  an  (siehe  auch  Abb. 
6.4).  Mit  Hilfe  dieser  Werte  (und  „doc“)  kann  der  Window-Manager  jederzeit  die  aktuel- 
len  SchiebergroBen  berechnen. 


RECT  work; 

Die  Bedeutung  ist  wie  „scroll“,  nur  ist  damit  der  Arbeitsbereich  des  Fensters  gemeint, 
d.h.  der  Bereich,  fiir  den  der  Programmierer  verantwortlich  ist  (siehe  auch  Abb.  6.4). 


WORD  mousenum; 

Jedes  Fenster  kann  seine  eigene  Mausform  haben.  Die  Nummer  der  Mausform  entspricht 
den  Konstanten  in  AES.H. 
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MFORM  *mouseform; 

Hat  „tnousenuni“  den  Wert  USERDEF  {=  255),  so  muB  „mouseform“  die  Adresse  der 
Mausform  enthalten.  Sie  ist  ein  Zeiger  auf  eine  Struktur  namens  MFORM  (siehe 
AES.H).  Ein  Beispiel  hierfiir  ist  im  Modul  POWER  gegeben. 


LONG  milli; 

Dies  ist  die  Anzahl  der  Millisekunden,  die  verstreichen  sollen,  bevor  das  Fenster  eine 
Aktion  durchfuhren  darf.  Ist  der  Zahler  0,  so  handelt  es  sich  urn  kein  Multitaskingfenster. 
Ein  Beispiel  wird  im  Modul  GRAF  gegeben.  Die  Genauigkeit  hangt  davon  ab,  welcher 
Wert  fur  den  Timer  beim  Aufruf  von  „evnt_multi“  iibergeben  wird  (siehe  Modul 
EVENT).  Soil  z.B.  der  Inhalt  eines  Fensters  alle  10  Minuten  auf  Diskette  gespeichert 
werden,  so  muB  in  „milli“  der  Wert  10  * 60  * 1000  = 600000  eingetragen  werden. 


LONG  count; 

Der  Zahler  fiir  die  Millisekunden  wird  intern  benutzt.  Immer  wenn  „count“  groBer  ist 
als  „milli“,  wird  ein  Zeitereignis  fiir  das  Fenster  ausgelost. 


LONG  special; 

Es  handelt  sich  um  einen  speziellen  Wert  fiir  jedes  Fenster.  Der  Wert  ist  von  der  Klasse 
des  Fensters  abhangig  und  kann  nicht  nur  eine  Langzahl  speichern,  sondern  vielmehr  ei- 
nen Zeiger  auf  eine  Struktur.  Die  Struktur  kann  praktisch  beliebige  GrbBe  haben.  Damit 
kdnnen  zu  jedem  Fenster  beliebige  Informationen  gespeichert  werden.  Beispielsweise 
kann  darin  ein  Zeiger  auf  den  Text  gespeichert  werden,  der  in  einem  Fenster  dargestellt 
wird. 

Alle  Variablen,  die  in  einer  Struktur  gespeichert  werden,  auf  die  „special“  zeigt,  sind 
lokal  zu  diesem  Fenster.  Das  bedeutet,  daB,  wann  immer  eine  Operation  auf  diesem  Fen- 
ster geschieht,  man  auf  diese  Variablen  zugreifen  kann.  Alle  Fenster  leben  damit  unab- 
hangig  voneinander.  Dies  ist  auch  die  Voraussetzung  fur  ein  sinnvolles  Multitasking  der 
Fenster  innerhalb  eines  Programms.  Jedes  Fenster  entspricht  damit  einer  Task,  die  auf 
ihren  eigenen  lokalen  Variablen  operiert.  Beispiele  fiir  die  Benutzung  einer  Struktur  in 
der  Variablen  „ special"  finden  wir  im  Modul  EDIT. 


STRING  name; 

Der  Name  des  Fensters  wird  hier  abgelegt. 


STRING  info; 

Die  Infozeile  des  Fensters  wird  hier  abgelegt. 


6.3  AUgemeine  Fensterverwaltung 


369 


OBJECT  *object; 

Dies  stellt  einen  Zeiger  auf  eine  Objektbaumstruktur,  die  im  Scrollbereich  des  Fensters 
angezeigt  werden  soil,  dar.  1st  er  NULL,  so  wird  kein  Objektbaum  im  Fenster  erwartet. 
Falls  ein  Objektbaum  im  Fenster  angemeldet  wird,  so  iibernimmt  der  Window-Manager 
dessen  Verwaltung  automatisch.  Das  bedeutet,  daB  sich  die  Applikation  um  folgende  Din- 
ge  nicht  kummern  muB:  Zeichnen  des  Fensterinhaltes,  Scrolling  des  Fensterinhalts,  Set- 
zen  der  Schieber  und  Einrasten  des  Fensters  auf  bestimmte  Positionen. 


OBJECT  *menu; 

Damit  meinen  wir  einen  Zeiger  auf  eine  Objektbaumstruktur,  die  eine  Menuzeile  dar- 
stellt.  1st  er  NULL,  so  wird  keine  Menuzeile  im  Fenster  erwartet.  Falls  eine  Menuzeile 
im  Fenster  angemeldet  wird,  ubernimmt  der  Window-Manager  deren  Verwaltung  auto- 
matisch. Die  Applikation  muB  lediglich  noch  dem  Window-Manager  bekannt  machen, 
welche  Routine  aufgerufen  werden  muB,  um  die  Menus  auszufuhren  und  um  sie  auf  den 
neuesten  Stand  zu  bringen. 


WORD  first_menu; 

Dies  ist  die  Nummer  des  ersten  im  Fenster  angezeigten  Mentis.  Der  Wert  wird  nur  intern 
fiir  den  Window-Manager  benotigt.  Falls  die  Menuzeile  nicht  ganz  ins  Fenster  paBt,  kann 
sie  gescrollt  werden,  so  daB  die  nicht  sichtbaren  Teile  ebenfalls  angewahlt  werden 
konnen. 

Nun  folgen  die  20  Zeiger  auf  die  Funktionen,  die  bei  bestimmten  Fensteroperationen  aus- 
gelost  werden  sollen.  Das  Prinzip  ist  ungefahr  folgendes:  Bei  einer  Fensteraktion  (z.B. 
beim  Offnen  eines  Fensters)  wird  vom  Window-Manager  nachgesehen,  ob  es  eine  Funk- 
tion  gibt,  die  ausgefuhrt  werden  soil.  Ist  das  der  Fall  (der  Zeiger  also  nicht  NULL),  so 
wird  sie  angesprungen.  Der  indirekte  Sprung  zu  Funktionen  wurde  bereits  weiter  oben 
erklart.  Da  der  Window-Manager  die  eigentliche  Funktion  nicht  kennt,  die  dahinter- 
steckt,  kann  das  Fenster  beim  Initialisieren  jede  beliebige  Routine  angeben,  sofern  deren 
Parameter  iibereinstimmen.  So  kann  zum  Beispiel  beim  Offnen  eines  Fensters  eine  sich 
vergroBernde  Box  gezeichnet  werden  oder  ein  Zugriffspfad  fur  eine  Datenbank  initiali- 
siert  werden. 

Bei  den  folgenden  Erklarungen  werden  die  Parameter  jeweils  in  ANSI-C-Schreibweise 
angegeben.  Der  Parameter  „window“  ist  in  alien  Fallen  ein  Zeiger  auf  die  aktuelle 
Window-Struktur  des  Fensters. 


VOID  (*updt_menu)  (WINDOWP  window); 


Die  Funktion  wird  vom  Window-Manager  aufgerufen,  bevor  die  Menuzeile  gezeichnet 
wird,  wenn  der  Benutzer  die  Menuzeile  angeklickt  hat  oder  wenn  er  eine  Taste  driickt. 
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fiir  die  ein  Meniipunkt  definiert  wurde.  Insbesondere  sollte  die  Funktion  genau  dann  ini- 
tialisiert  werden,  wenn  eine  Menuzeile  fiir  ein  Fenster  definiert  wurde.  In  dieser  Funktion 
werden  iiblicherweise  die  Menus  eingestellt,  d.h.  einzelne  Meniititel  oder  Meniieintrage 
grau  Oder  abgehakt  eingestellt  (DISABLED  oder  CHECKED).  Beispiele  sind  in  den 
Modulen  CLIPBRD  und  EDIT  zu  finden. 


VOID  (*hndl_menu)  (WINDOW?  window,  WORD  title,  WORD  item); 

Die  Funktion  wird  vom  Window-Manager  aufgerufen,  wenn  der  Benutzer  ein  Menii  in 
einem  Fenster  angewahit  hat.  „title“  ist  die  Nummer  des  Titels,  „item“  die  Nummer  des 
Eintrags  im  Meniibaum.  Diese  Funktion  sollte  initialisiert  werden,  wenn  eine  Menuzeile 
fiir  ein  Fenster  definiert  wurde.  Ein  Beispiel  ist  in  dem  Modul  CLIPBRD  zu  finden. 


BOOLEAN  (*test)  (WINDOW?  window,  WORD  action); 

Diese  Funktion  wird  vom  Window-Manager  aufgerufen,  bevor  ein  Fenster  geschlossen 
oder  geloscht  wird.  Der  Parameter  „action“  gibt  dabei  die  Aktion  an,  die  gerade  ausge- 
fiihrt  werden  soli.  Weiterhin  wird  die  Funktion  im  Modul  MENU  aufgerufen,  um  zu  te- 
sten,  ob  Cut/Copy /Paste-Operationen  in  diesem  Fenster  moglich  sind.  Der  Funktionswert 
ist  TRUE,  wenn  das  Fenster  geschlossen  oder  geloscht  werden  darf  oder  wenn  Cut/ 
Copy /Paste-Operationen  moglich  sind.  Die  Werte  von  „action“  konnen  sein  (siehe 
WINDOWS.  H); 

DO  UNDO:  Test,  ob  eine  Undo-Operation  moglich  ist.  Das  ist  iiblicherweise  nach 
dem  Verandern  eines  Dokuments  der  Fall. 

DO_CUT:  Test,  ob  eine  Cut-Operation  moglich  ist.  Das  ist  iiblicherweise  nach  Markie- 
ren  eines  Blocks  der  Fall. 

DO  COPY:  Test,  ob  eine  Copy-Operation  moglich  ist.  Das  ist  iiblicherweise  nach 
Markieren  eines  Blocks  der  Fall. 

DO_PASTE:  Test,  ob  eine  Paste-Operation  moglich  ist.  Das  ist  iiblicherweise  nach  ei- 
ner  Cut-  oder  Copy-Operation  der  Fall,  wenn  also  der  Puffer  gefiillt  ist. 
DO_CLEAR:  Test,  ob  eine  Clear-Operation  moglich  ist.  Das  ist  ublicherweise  nach 
Markieren  eines  Blocks  der  Fall. 

DO_SELALL:  Test,  ob  eine  Select-All-Operation  moglich  ist.  Dies  sollte  immer  der 
Fall  sein. 

DO_CLOSE:  Test,  ob  das  Fenster  nach  Anklicken  der  Schliellbox  wirklich  geschlossen 
werden  soil.  An  dieser  Stelle  kann  z.B.  eine  Abfrage  erfolgen,  ob  das  Dokument,  welches 
im  Fenster  dargestellt  wird,  noch  auf  die  Diskette  gerettet  werden  soli.  Wahlt  der  Benut- 
zer den  Abbruch-Knopf,  so  wird  das  Fenster  doch  nicht  geschlossen. 

DO_DELETE:  Test,  ob  das  Fenster  geloscht  werden  soil.  An  dieser  Stelle  kann  wie 
oben  eine  Sicherheitsabfrage  erfolgen.  Dies  ist  insbesondere  dann  sinnvoll,  wenn  beim 
normalen  Schlieben  der  Fensterinhalt  nicht  geloscht  wird,  d.h.  das  Flag 
WI_RESIDENT  (s.o.)  eingeschaltet  ist.  Ein  Beispiel  finden  wir  beim  Texteditor 
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TEMPUS.  Dort  kann  das  Fenster  durch  Anklicken  des  entsprechenden  Icons  wieder  ge- 
dffnet  werden.  Die  Sicherheitsabfrage  muBte  dann  z.B.  bei  der  Operation  „Text-Icon  auf 
Papierkorb-Icon  ziehen“  erfolgen. 

DO_EXTERNAL:  1st  zusatzlich  das  niederwertige  Bit  im  oberen  Byte  gesetzt,  dann 
sollen  sich  die  obigen  Operationen  (Undo,  Cut,  Copy,  Paste)  auf  den  externen  Puffer  be- 
ziehen,  d.h.  auf  das  GEM-Clipboard,  Bei  einer  Abfrage  niuB  also  immer  das  obere  Byte 
mit  ausgewertet  bzw.  ausgeblendet  werden. 


Beispieie  finden  sich  in  den  Modulen  MENU  und  EDIT. 


VOID  (*open)  (WINDOWP  window); 

Die  Funktion  wird  unmittelbar  vor  dem  Offnen  eines  Fensters  aufgerufen.  Sinnvolle  Ak- 
tionen  an  dieser  Stelle  konnen  sein:  Zeichnen  einer  sich  ausdehnenden  Box  oder  Initiali- 
sieren  eines  Zugriffspfads  etc.  Beispieie  sind  in  alien  Modulen  angegeben,  welche  Fenster 
benutzen. 


VOID  (*close)  (WINDOWP  window); 

Die  Funktion  wird  unmittelbar  nach  dem  SchlieBen  eines  Fensters  aufgerufen.  Sinnvolle 
Aktionen  an  dieser  Stelle  konnen  sein:  Zeichnen  einer  sich  zusammenziehenden  Box  oder 
Freigeben  eines  Zugriffspfads  etc.  Beispieie  sind  in  alien  Modulen  angegeben,  welche 
Fenster  benutzen. 


VOID  (*delete)  (WINDOWP  window); 

Die  Funktion  wird  unmittelbar  vor  dem  Loschen  eines  Fensters  aufgerufen.  Sinnvolle  Ak- 
tionen an  dieser  Stelle  konnen  sein;  Abspeichern  des  aktuellen  Fensterinhalts  bzw.  Doku- 
mentes. 


VOID  (*draw)  (WINDOWP  window); 

Die  Funktion  wird  aufgerufen  wenn  der  Fensterinhalt  gezeichnet  werden  soil.  Dies  ist 
z.B.  nach  einer  Redraw-Nachricht  von  GEM  der  Fall.  Diese  Funktion  ist  einer  der  Haupt- 
grunde  fiir  das  Einfiihren  der  indirekten  Funktionsaufrufe.  Der  Window-Manager  kann 
nicht  wissen,  welcher  Inhalt  sich  in  den  Fenstern  befindet.  Er  beriicksichtigt  allerdings 
eine  eventuell  vorhandene  Meniizeile  und  die  Rechteckliste.  Dann  springt  er  fur  jedes 
freiliegende  Rechteck  die  Funktion  „draw“  an.  Das  aktuelle  Clipping  wurde  vorher  ein- 
gestellt  und  kann  durch  Inspizieren  der  globalen  Variablen  „clip“  (siehe  GLOBAL. H) 
in  den  Zeichenalgorithmus  eingehen.  Beispieie  sind  in  alien  Modulen  zu  finden,  die  Fen- 
ster benutzen. 
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VOID  (*arrow)  (WINDOW?  window,  WORD  dir,  LONG  oldpos,  LONG  newpos); 

Die  Funktion  wird  aufgerufen,  wenn  der  Benutzer  entweder  einen  Pfeil  in  einem  Fenster 
angeklickt  oder  den  Schieber  bewegt  hat.  „dir“  gibt  die  Richtung  an,  also  entweder  HO- 
RIZONTAL Oder  VERTICAL  (siehe  WINDOWS. H).  „oldpos“  bezeichnet  die  alte  Posi- 
tion, „newpos“  die  neue  Position  im  Dokument.  Abhangig  von  diesen  Werten  konnen 
nun  verschiedene  Dinge  durchgefuhrt  werden,  z.B.  das  Vorriicken  eines  internen  Cursors 
fur  Textzeilen  oder  Datensatze.  Beispiele  finden  sich  in  alien  Modulen,  welche  Fenster 
mit  Schiebern  benutzen. 


VOID  (*snap)  (WINDOW?  window,  RECT  *new,  WORD  mode); 

Die  Funktion  wird  aufgerufen,  wenn  das  Fenster  auf  eine  bestimmte  Position  oder  GroBe 
einrasten  soil.  Dies  ist  immer  nach  einem  Bewegen  oder  VergroBem/Verkleinem  des 
Fensters  der  Fall.  Dadurch  kann  die  Applikation  bestimmen,  ob  bestimmte  Pixelpositio- 
nen  eingehalten  werden  sollen. 

Es  hat  sich  gezeigt,  daB  z.B.  die  Textausgabe  wesentlich  schneller  vonstatten  geht,  wenn 
sie  an  einer  (horizontalen)  Position  beginnt,  die  durch  8 teilbar  ist,  also  an  den  Positionen 
0,  8,  16,  usw.  AuBerdem  erscheint  es  bisweilen  sinnvoll,  nur  eine  glatte  Anzahl  von  z.B. 
Zeichen  in  einer  Zeile  darzustellen,  damit  man  einen  schnelleren  Algorithmus  beim 
Zeichnen  anwenden  kann.  SchlieBlich  muB  die  Meniizeile  innerhalb  eines  Fensters  immer 
an  geraden  Y-Postionen  stehen,  da  sonst  die  grau  eingestellten  Menus  mit  anderen  Bitmu- 
stern  grau  gezeichnet  werden,  was  bei  einigen  Buchstaben  merkwiirdig  aussieht.  Zu  die- 
sen Buchstaben  gehoren  auch  die  Zeichen  fiir  Control  ('')  und  Alternate  (Raute). 


VOID  (*objop)  (WINDOW?  window,  SET  objs,  WORD  action); 

Die  Funktion  wird  aufgerufen,  wenn  innerhalb  eines  Fensters  Objekte  selektiert  waren 
und  eine  der  drei  Standardfunktionen  „6ffnen“,  „Info“  und  „Hilfe“  (im  Modul  MENU) 
gewahlt  wird.  „objs“  ist  die  Menge  von  Objekten,  die  selektiert  ist,  „action“  kann  einen 
der  drei  folgenden  Werte  annehmen: 

OBJ_OPEN:  Die  Objekte  werden  zum  Offnen  angefordert. 

OBJ_INFO:  Es  wird  Information  uber  die  Objekte  verlangt. 

OBJ_HELP:  Es  wird  eine  Hilfemeldung  uber  die  Objekte  verlangt. 

Da  es  sich  immer  um  eine  Menge  von  Objekten  handelt,  konnen  durchaus  mehrere  selek- 
tierte  Objekte  auf  einmal  gedffnet  werden.  Dies  ist  zum  Beispiel  auch  beim  Macintosh 
Finder  der  Fall,  wo  mehrere  Dateien  auf  einmal  selektiert  werden  konnen  und  beim  Auf- 
ruf  von  Info  die  Information  iiber  alle  Objekte  erscheint.  Beim  GEM  Desktop  ist  dies 
nicht  der  Fall.  Beispielaufrufe  finden  sich  im  Modul  MENU. 
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WORD  (*drag)  (WINDOW?  src_ window,  WORD  src_obj, 

WINDOW?  dest_window,  WORD  dest_obj); 

Wenn  ein  Objekt  von  einem  Fenster  in  ein  anderes  geschoben  wird,  so  wird  diese  Funk- 
tion  vom  Window-Manager  aufgerufen.  Sie  wird  nur  benotigt.  wenn  Objekte  in  ein  Fen- 
ster geschoben  werden  kbnnen  und  dies  eine  Wirkung  hat,  wie  zum  Beispiel  bei  geoffne- 
tem  Fapierkorbfenster  und  einem  Ziehen  einer  Datei  in  dasselbe.  Die  Funktion  wird  noch 
ausfuhrlicher  bei  der  Beschreibung  der  Funktion  „drag_to_window“  erkJart. 
„src_window“  gibt  das  Ursprungsfenster  an,  aus  dem  ein  Objekt  gezogen  wurde, 
„src_obj“  gibt  die  Nummer  des  Objekts  an,  welches  verschoben  wurde. 
„dest_window“  gibt  das  Zielfenster  und  „dest_obj“  das  Zielobjekt  an,  falls  ein  solches 
existiert.  Als  Ruckgabewert  kann  ein  WORD  angegeben  werden.  Einige  Werte  (Konstan- 
ten)  sind  fiir  Riickgabewerte  bereits  vordefiniert  (siehe  WINDOWS. H).  Sie  bedeuten; 

DRAG_OK:  Die  Drag-Operation  ist  ok. 

DRAG_SWIND;  Das  Objekt  wurde  innerhalb  des  gleichen  Fensters  verschoben. 
DRAG_SCLASS;  Das  Objekt  wurde  auf  ein  Fenster  der  gleichen  Klasse  gezogen,  also 
z.B.  von  einem  Dateifenster  in  ein  anderes,  aber  nicht  von  einem  Dateifenster  in  ein  ?a- 
pierkorbfenster. 

DRAG_NOWIND:  Das  Zielfenster,  in  welches  das  Objekt  gezogen  wurde,  gehort  nicht 
zum  gleichen  FrozeB,  kann  also  z.B.  ein  Fenster  von  einem  Deskaccessory  sein.  In  einer 
Multitasking-Umgebung  sollte  dem  fremden  FrozeB  mittels  „wind_apfind“  eine  Nach- 
richt  gesendet  werden. 

DRAG_NORCVR;  Das  Zielfenster  gehort  zwar  zum  eigenen  FrozeB,  stellt  aber  keine 
Routine  zur  Verfiigung,  um  Drag-Operationen  auszuwerten. 

DRAG_NOACTN:  Das  Zielfenster  besitzt  zwar  ein  Routine,  welche  auf  eine  Drag- 
Operation  reagiert,  kann  aber  mit  dem  Objekt  nichts  anfangen. 


VOID  (*click)  (WINDOW?  window,  MKINFO  *mk); 

Bei  jedem  Klick  in  ein  Fenster  wird  diese  Funktion  aufgerufen.  Dabei  werden  genaueste 
Informationen  iiber  den  Status  der  Maus  und  der  Tastatur  in  der  Variablen  „mk“  iiberge- 
ben.  Die  Struktur  MKINFO  (Mouse-Keyboard-Info)  enthalt  die  Mauskoordinaten,  den 
Status  der  Kndpfe  und  der  Shift-Tasten.  Das  Fenster  kann  dann  auf  einen  Einfach-,  einen 
Doppelklick  oder  eine  Ziehoperation  reagieren.  Dabei  kbnnen  selektierte  Objekte  hervor- 
gehoben  werden.  Beispiele  finden  sich  in  den  Modulen  CLIFBRD,  DESKTO?  und 
FOWER. 


VOID  (*unclick)  (WINDOW?  window); 

Wurde  ein  Fenster  angeklickt,  so  waren  dort  eventuell  Objekte  selektiert.  Wird  nun  in 
ein  anderes  Fenster  geklickt,  so  kbnnen  diese  Objekte  vorher  deselektiert  werden.  Das 
geschieht  mit  der  Funktion  „unclick“.  Beispiele  fmden  sich  in  den  Modulen  CLIFBRD 
und  DESKTOF. 


374 


6 Ein  universelles  Modulkonzept  in  C 


BOOLEAN  (*key)  (WINDOWP  window,  MKINFO  *mk); 

Wenn  der  Benutzer  eine  Taste  driickt,  so  ordnet  der  Window-Manager  diese  dem  ober- 
sten  Fenster  zu.  Dabei  wird  an  dieses  das  gesamte  Informationspaket  in  der  Struktur 
„mk“  iibergeben,  ahnlich  wie  es  bei  „click“  der  Fall  ist.  Zu  den  Informationen  zahlen 
der  ASCII-Code,  der  Scan-Code,  sowie  der  Status  der  Shift-Tasten. 

Das  oberste  Fenster  kann  nun  entscheiden,  ob  es  die  Taste  fur  sich  verbrauchen  will  oder 
nicht.  Im  ersten  Fall  wird  als  Ruckgabewert  TRUE  angegeben.  Fur  den  Fall,  daB  die  Rou- 
tine FALSE  zuriickgibt,  sucht  der  Window-Manager  das  nachstobere  Fenster  und  bietet 
diesem  die  Taste  an.  Dieses  kann  nun  ebenfalls  entscheiden,  ob  es  auf  die  Taste  reagieren 
mochte.  Das  letzte  Fenster,  das  die  Taste  dann  bekommt,  ist  (bei  regularen  Applikatio- 
nen)  der  Desktop.  Beispiele  werden  in  den  Modulen  CLIPBRD,  DESKTOP,  EDIT, 
GRAF  und  POWER  angegeben. 


VOID  (*timer)  (WINDOWP  window); 

Die  Funktion  wird  angesprungen,  wenn  die  Zeit  verstrichen  ist,  die  in  der  Variablen  „mil- 
li“  (s.o)  angegeben  ist.  Dadurch  kann  das  Fenster  eine  Aktion  ausfuhren.  Falls  dies  mit 
mehreren  Fenstern  gemacht  wird,  entsteht  der  Eindruck  von  Multitasking  innerhalb  eines 
Programms.  Ein  Beispiel  ist  im  Modul  GRAF  angegeben. 


VOID  (*top)  (WINDOWP  window); 

Wenn  ein  Fenster  nach  oben  gebracht  wird,  so  wird  diese  Funktion  angesprungen.  Zwei 
Griinde  kann  es  dafur  geben.  Zunachst  kann  eine  entsprechende  Meldung  vom  Screen- 
Manager  des  GEM  kommen.  In  diesem  Fall  wird  die  Nachricht  WM_TOPPED  an  die 
Applikation  geschickt.  Der  zweite  Fall  ergibt  sich  beim  SchlieBen  eines  Fensters.  Das 
vorher  zweitoberste  Fenster  kommt  nun  nach  oben.  Dann  wird  vom  Window-Manager 
die  Funktion  angesprungen.  In  dieser  Funktion  konnte  z.B.  das  Restaurieren  des  Fensters 
aus  einem  zuvor  geretteten  Puffer  geschehen. 


VOID  (*untop)  (WINDOWP  window); 

Die  Gegenfunktion  von  oben  wird  angesprungen,  wenn  ein  Fenster  nach  unten  kommt. 
Dafiir  kann  es  mehrere  Griinde  geben.  Zunachst  kann  eine  entsprechende  Meldung 
vom  Screen-Manager  des  GEM  kommen.  In  diesem  Fall  wird  die  Nachricht 
WM_UNTOPPED  an  die  Applikation  geschickt.  Die  funktioniert  aber  erst  ab  GEM 
2.x.  Die  Meldung  kommt  genau  dann,  wenn  ein  anderes  Fenster  mittels  „WF_TOP“ 
nach  oben  gebracht  wird.  Der  im  alten  GEM  fehlende  Aufruf  wird  dabei  vom  Window- 
Manager  nachgeholt.  Der  zweite  Grund  kann  das  Offnen  eines  Fensters  sein.  In  diesem 
Fall  wird  das  oberste  aktive  Fenster  inaktiv,  und  die  Funktion  wird  angesprungen.  In 
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dieser  kdnnte  z.B.  das  Retten  des  Fensterinhaltes  realisiert  sein,  bevor  andere  Fenster 
sich  dariiber  legen  und  diesen  zerstdren. 


VOID  (*edit)  (WINDOW?  window,  WORD  action); 


Die  Funktion  wird  angesprungen,  wenn  vom  Edit-Menii  eine  der  Funktionen  Undo,  Cut, 
Copy,  Paste,  Clear  oder  Select  All  aufgerufen  wird.  „action“  kann  dabei  die  Werte  an- 
nehmen: 


DO_UNDO 

DO_CUT 

DO  COPY 

DO  PASTE 

DO_CLEAR 

DO_SELALL 

DO_EXTERNAL 


Die  letzte  Funktion  soli  riickgangig  gemacht  werden. 
Der  markierte  Block  soil  ausgeschnitten  werden, 

Der  markierte  Block  soil  kopiert  werden. 

Der  Puffer  soil  eingefiigt  werden. 

Der  markierte  Block  soil  geloscht  werden. 

Das  gesamte  Dokument  soil  markiert  werden. 

Die  Operationen  beziehen  sich  auf  das  GEM-Clipboard. 


Was  das  Fenster  nun  im  einzelnen  durchfiihrt,  bleibt  seine  Sache.  Ob  die  Operationen 
mdglich  sind,  hangt  davon  ab,  ob  der  Test  iiber  die  Funktion  „test“  (s.o.)  erfolgreich  war. 


BOOLEAN  (*showinfo)  (WINDOW?  window,  WORD  icon); 

Die  Funktion  wird  aufgerufen,  wenn  der  Benutzer  das  Menii  „Info“  anwahlt.  Dabei  gibt 
es  zwei  Moglichkeiten.  Entweder  ist  ein  Objekt  angewahlt  (invertiert),  dann  wird  das  se- 
lektierte  Fenster  iiber  die  Funktion  „objop“  angesprungen  (s.o).  Dieses  Fenster  entschei- 
det  dann,  welche  Funktionen  fur  die  angewahlten  Objekte  angesprungen  werden  mtissen. 
Ist  kein  Objekt  in  einem  Fenster  selektiert,  so  wird  die  Info-Funktion  des  obersten  Fen- 
sters  angesprungen,  „window“  zeigt  in  diesem  Fall  auf  das  oberste  Fenster.  „icon“  gibt 
die  Objektnummer  des  angewahlten  Objekts  an,  z.B.  ein  Piktogramm.  Beispiele  zu  dieser 
Funktion  finden  sich  in  den  Modulen  CLIPBRD,  DESKTOP  und  MENU. 


BOOLEAN  (*showhelp)  (WINDOW?  window,  WORD  icon); 

Die  Funktion  hat  dieselbe  Bedeutung  wie  „showinfo“,  jedoch  wird  sie  angesprungen, 
wenn  der  Benutzer  das  Menii  „Hilfe“  anwahlt.  Ansonsten  gilt  das  schon  oben  gesagte. 

Ein  Modul  muB  nun  die  oben  erklarte  Struktur  WINDOW  mit  konkreten  Werten  ftillen, 
damit  der  Window-Manager  seine  Arbeit  verrichten  kann.  Besonders  wenn  mehrere  Fen- 
ster geoffnet  werden  konnen,  mtissen  diese  zuerst  kreiert  werden.  Jedes  Modul,  das  Fen- 
ster offnen  kann,  sollte  deshalb  die  schon  weiter  oben  beschriebenen  Grundfunktionen 
besitzen.  Sie  sollen  an  dieser  Stelle  noch  einmal  mit  den  Parametern  erklart  werden.  Statt 
des  Wortes  „module“  sollte  man  sich  ein  konkretes  Objekt  vorstellen,  z.B.  „image“  ftir 
die  Fenster,  welche  Image-Dateien  anzeigen  konnen. 
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— Kreieren  eines  Fensters 

GLOBAL  WINDOW?  crt_module  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon,  ...); 

„obj“  gibt  einen  Objektbaum  an,  der  sich  im  Fenster  befmden  kann  (siehe  6.3). 

„menu“  gibt  die  Meniizeile  an,  die  sich  im  Fenster  befinden  kann  (siehe  6.3). 

„icon“  gibt  das  Piktogramm  an,  aus  welchem  das  Fenster  entstehen  wird,  falls  es  exi- 
stiert. 

Die  Funktion  liefert  einen  Zeiger  auf  eine  Fensterstruktur  zuriick  (siehe  6.3).  Alle  Varia- 
blen  der  Fensterstruktur  WINDOW  sollten  in  dieser  Funktion  initialisiert  werden.  Falls 
die  drei  Parameter  von  oben  nicht  ausreichen,  konnen  auch  weitere  Parameter  definiert 
werden.  Im  Modul  EDIT  finden  wir  z.B.  noch  die  Parameter  „filename“  und  „size“. 
Sie  geben  den  Dateinamen  und  die  maximale  GroBe  an,  die  fiir  die  Datei  reserviert  wer- 
den soil,  welche  geoffnet  wird.  Beispiele  dafiir  finden  sich  in  alien  Modulen,  die  Fenster 
offnen  konnen. 


— Offnen  eines  Fensters  (oder  einer  Dialogbox  etc.) 

GLOBAL  BOOLEAN  open  module  (WORD  icon,  ...); 

„icon“  hat  dieselbe  Bedeutung  wie  oben. 

Die  Funktion  liefert  TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst. 
Beim  Offnen  eines  Fensters  konnen  auch  noch  weitere  Parameter  iibergeben  werden. 
Wichtig  kann  z.B.  ein  Dateinaine  sein,  der  geladen  werden  soil.  Im  Modul  EDIT  wird 
dies  beispielhaft  gezeigt. 


— Information  eines  Fensters 

GLOBAL  BOOLEAN  info_module  (WINDOW?  window,  WORD  icon); 

„window“  gibt  das  Fenster  an,  von  welchem  Information  angezeigt  werden  soli. 

„icon“  gibt  das  Piktogramm  an,  von  welchem  Information  gezeigt  werden  soli. 

Die  Funktion  sollte  folgendermafien  ablaufen  (siehe  auch  „info_edit“  im  Modul  EDIT). 
1st  ein  Piktogramm  liber  den  Parameter  „icon“  angegeben  („icon“  !=  NIL),  so  sollte 
das  entsprechende  Fenster  dazu  gesucht  werden.  1st  dies  nicht  der  Fall,  so  sollte  der  Para- 
meter „window“  benutzt  werden,  um  die  zum  zugehorigen  Fenster  gehorende  Informa- 
tion anzuzeigen.  Dutch  diesen  Algorithmus  ergibt  sich  der  Effekt,  daB  dutch  das  Modul 
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MENU  zunachst  ein  aktives  (invertiertes)  Objekt  berucksichtigt  werden  kann,  dann  erst 
das  oberste  Fenster, 


— Hilfe  eines  Fensters 

GLOBAL  BOOLEAN  help  module  (WINDOW?  window,  WORD  icon); 

„window“  gibt  das  Fenster  an,  zu  dem  Hilfe  angezeigt  werden  soli. 

„icon“  gibt  das  Piktogramm  an,  zu  dem  Hilfe  gezeigt  werden  soli. 

Die  Funktion  sollte  folgendermaBen  ablaufen.  1st  ein  Piktogramm  iiber  den  Parameter 
„icon“  angegeben  („icon“  !=  NIL),  so  sollte  das  entsprechende  Fenster  dazu  gesucht 
werden.  1st  dies  nicht  der  Fall,  so  sollte  der  Parameter  „window“  benutzt  werden,  um 
die  zum  zugehorigen  Fenster  gehorende  Hilfe  anzuzeigen.  Durch  diesen  Algorithmus  er- 
gibt  sich  der  Effekt,  dal)  durch  das  Modul  MENU  zunachst  ein  aktives  (invertiertes)  Ob- 
jekt berucksichtigt  werden  kann,  dann  erst  das  oberste  Fenster. 

Wie  arbeitet  nun  der  Window-Manager?  Allgemein  gilt  folgendes:  Eine  Applikation 
kreiert  verschiedene  Fenster  uber  ein  oder  mehrere  Module  („crt_module“).  Die  Fen- 
ster werden  beim  Window-Manager  in  eine  Liste  eingetragen.  Er  wei6  dann  immer,  wel- 
che  Fenster  sich  in  welcher  Reihenfolge  offen  oder  geschlossen  auf  dem  Bildschirm  befm- 
den.  Zu  jedem  Fenster  gibt  es  eine  Reihe  von  Funktionen,  die  oben  beschrieben  wurden. 

Trifft  nun  eine  Nachricht  ein,  so  daB  z.B.  ein  Fenster  geoffnet  werden  muB,  so  wird  ein- 
fach  die  Funktion  „open_module“  des  entsprechenden  Moduls  aufgerufen.  Dieses  ruft 
dann  seinerseits  eine  Funktion  des  Window-Managers  auf,  namlich  „open_window“ 
(s.u.).  Diese  erledigt  wiederum  alle  Aktionen,  welche  GEM  benotigt,  um  das  Fenster  auf 
den  Bildschirm  zu  bringen. 

Durch  die  bekannte  Struktur  WINDOW  kann  die  Funktion  „open_window“  aber  noch 
mehr  tun.  Handelt  es  sich  beispielsweise  um  ein  Fenster  mit  „kind“  0 (=  DESK),  so 
wird  start  des  Offnens  des  Fensters  der  Desktop  angemeldet.  Vor  dem  eigentlichen  6ff- 
nen  wird  eventuell  ein  Fenster,  welches  verdeckt  wird,  dazu  veranlaBt,  eine  Aktion 
durchzufiihren  („untop“)-  Dann  wird  fiir  das  zu  dffnende  Fenster  die  Routine  „open“ 
aufgerufen,  um  eine  Aktion  beim  Offnen  auszufiihren  (z.B.  eine  Box  zu  zeichnen). 

Erst  dann  wird  das  Fenster  tatsachlich  geoffnet.  Dabei  werden  alle  Attribute  des  Fensters 
berucksichtigt.  Name  und  Infozeile  werden  gesetzt.  Falls  Schieber  existieren,  werden 
diese  ebenfalls  gesetzt. 

Bei  anderen  Fensteraktionen  wird  ebenfalls  eine  Reihe  von  Aktionen  durchgefuhrt.  Das 
Schema  ist  immer  das  gleiche.  Der  Window-Manager  versucht,  moglichst  viele  Aktio- 
nen, die  allgemein  fiir  alle  Fenster  gelten,  auszufiihren.  Der  Unterschied  ergibt  sich  je- 
weils  durch  die  Angabe  der  Funktionen  in  der  Struktur  WINDOW,  die  vom  Window- 
Manager  bei  den  entsprechenden  Aktionen  (indirekt)  aufgerufen  werden.  Ein  weiterer 
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Unterschied  ergibt  sich  durch  die  Inhalte  der  Variablen  in  der  Struktur  WINDOW.  Dutch 
richtige  Besetzung  der  Variablen  „doc“  kann  die  SchiebergroBe  automatisch  berechnet 
werden.  Bei  Angabe  der  Variablen  „object“  bzw.  „menu“  wird  die  Objektbaumverwal- 
tung  bzw.  die  Meniiverwaltung  des  Window-Managers  dazu  veranlaBt,  vollautomatisch 
die  entsprechenden  Aktionen  auszufuhren. 

Das  Modul  WINDOWS  mit  seiner  Schnittstelle  wird  weiter  unten  bei  der  Modulbeschrei- 
bung  erlautert.  Dort  wird  fiir  jede  der  52  Funktionen  erkart,  wie  und  wann  sie  aufgerufen 
werden  sollte. 


6.4  Programmierumgebungen  fiir  SCRAP 

Bevor  auf  die  Modulbeschreibung  eingegangen  wird,  soli  die  Programmierumgebung  fiir 
die  Beispielapplikation  erklart  werden.  In  Kapitel  3 wurde  bereits  erklart,  wie  die  einzel- 
nen  Dateien  im  Verzeichnis  MISC  auf  die  Inhaltsverzeichnisse  der  Compiler  iibertragen 
werden  sollen.  Die  dort  erklarten  Schritte  sollten  auf  jeden  Fall  zuerst  durchgefiihrt  wer- 
den. Nun  geht  es  datum,  fur  jedes  Betriebssystem  die  Umgebung  herzustellen,  mit  der 
am  besten  gearbeitet  werden  kann. 

Fur  alle  Betriebssysteme  gilt  zunachst  einmal:  Kopieren  des  Ordners  SCRAP  der  Begleit- 
diskette  auf  irgendeine  Partition  in  irgendeinen  Ordner  der  Festplatte.  Falls  Sie  keine 
Festplatte  besitzen,  sollten  Sie  den  Ordner  auf  eine  Arbeitsdiskette  kopieren.  Falls  Sie 
keine  zwei  Laufwerke  haben,  kdnnen  Sie  den  Ordner  auch  auf  eine  Ramdisk  iiberspielen. 
Falls  Sie  nur  ein  Laufwerk  und  nicht  geniigend  Speicher  haben,  sollten  Sie  erwagen,  ob 
Sie  sich  nicht  einen  Massenspeicher  wie  eine  Festplatte  zulegen  sollten.  Das  erspart  Ihnen 
beim  ernsthaften  Arbeiten  einige  graue  Haare  bzw.  wertvolle  Tage  Ihres  Lebens. 

Als  Beispiel  haben  wir  nun  den  Ordner  SCRAP  auf  die  Partition  D:  der  Festplatte  kopiert, 
so  daB  dort  nun  der  Ordner 

D:\SCRAP 

mit  alien  Dateien  vorliegen  soil.  Falls  Ihr  Ordner  sich  auf  Laufwerk  B:  befindet,  miissen 
Sie  sich  an  alien  Stellen,  an  welchen  D:\SCRAP  steht,  ein  B:\SCRAP  vorstellen. 

Da  die  Resource-Dateien  nicht  direkt  kompatibel  sind,  kopieren  Atari-Besitzer  die  Datei- 
en des  Ordners  A:\SCRAP\M68000.RSC  ebenfalls  in  den  Ordner  D:\SCRAP.  Es  sind 
dies  die  Dateien 

SCRAP.  DEF 
SCRAP.RSC 

Besitzer  eines  Rechners  mit  Intel-Prozessor  (Betriebssysteme  MS-DOS  Oder  FlexOS)  ko- 
pieren die  Dateien  des  Ordners  A:\SCRAP\I8086.RSC  ebenfalls  in  den  Ordner 
D:\SCRAP.  Es  sind  dies  die  Dateien 
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SCRAP.DFN 

SCRAP.RSC 

Nun  rniissen  wir  uns  entscheiden,  mit  welchem  Compiler  wir  arbeiten  wollen.  Fiir  jedes 
Betriebssystem  warden  die  einzelnen  Compiler  aufgefuhrt.  Auf  der  Begleitdiskette  befm- 
det  sich  zu  jedem  Betriebssystem  ein  Ordner  mit  dem  entsprechenden  Namen,  d.h.  GEM- 
DOS,  MS-DOS  und  FLEXOS.  In  diesen  Ordnern  befinden  sich  wiederum  Ordner  fur  je- 
den  Compiler  des  entsprechenden  Betriebssy stems.  Von  diesem  rniissen  jeweils  Dateien 
auf  die  Arbeitsdiskette/Festplatte  in  den  Ordner  SCRAP  kopiert  werden.  Wir  gehen  im 
folgenden  davon  aus,  daB  sich  die  Begleitdiskette  in  Laufwerk  A befindet. 


6.4.1  GEMDOS 

Wenn  Sie  auf  einem  Atari  ST  arbeiten,  konnen  Sie  unter  mehreren  Compilem  wahlen. 
Die  Auflistung  erfolgt  hier  alphabetisch,  nicht  nach  Beliebtheit. 


a)  Digital  Research  C 


Wenn  Sie  noch  mit  diesem  ersten  C-Compiler  fiir  den  Atari  ST  arbeiten,  so  sollten  Sie 
zusatzlich  einen  Kommandointerpretierer  haben  (COMMAND.PRG),  damit  Sie  wenig- 
stens  Batch-Dateien  ausfiihren  konnen.  Das  gleiche  gilt  fur  den  Nachfolger  ALCYON 
C.  Sie  kopieren  nun 

A:\GEMDOS\DR_C\C.BAT  ->  D:\SCRAP 

A:\GEMDOS\DR_C\L.BAT  ->  D:\SCRAP 

A:\GEMDOS\DR  C\C  ALL.BAT  ->  D:\SCRAP 


Urn  nun  ein  Modul  zu  kompilieren,  geben  Sie  (z.B.  fiir  GLOBAL) 
c global 

ein.  Die  Batch-Datei  „C.BAT“  startet  dann  samtliche  Phasen  des  Compilers  und  des  As- 
semblers. Am  Ende  wird  noch  der  Archiver  aufgerufen,  da  an  den  Linker  spater  nicht 
so  viel  Module  iibergeben  werden  konnen.  Aus  diesem  Grund  werden  alle  Module  in  ei- 
ner  Bibliothek  gehalten,  die  dann  zusammengelinkt  werden. 

Wollen  Sie  danach  linken,  geben  Sie  einfach 

1 


ein.  Dann  wird  der  Linkvorgang  gestartet. 
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Miissen  Sie  alle  Module  ubersetzen,  dann  konnen  Sie 
c_all 

eingeben.  Dann  werden  alle  Module  iibersetzt  und  anschlieBend  gelinkt.  Vorausgesetzt 
Sie  haben  geniigend  Platz  auf  Ihrer  Festplatte  oder  Ramdisk  (der  Assembler  offnet  unge- 
fahr  zehn  Zwischendateien),  so  konnen  Sie  allerdings  getrost  ins  Kino  oder  ins  Theater 
gehen.  Der  DR  C-Compiler  bzw.  der  Alcyon  C-Compiler  gehoren  mit  Ihren  vier  Durch- 
laufen  und  langen  Ubersetzungszeiten  zu  den  Schnecken  unter  den  Compilern.  Am  Ende 
liegt  das  ausfiihrbare  Programm  SCRAP. PRG  vor,  welches  Sie  wie  gewohnt  vom  Desk- 
top starten  konnen. 


b)  Laser  C 

Im  Gegensatz  zum  DR  C-Compiler  gehort  der  Laser  C (ab  Version  1 .2)  zu  den  schnell- 
sten  Compilern  auf  dem  Atari  ST.  Gliicklicherweise  hat  er  auBerdem  ein  integriertes  Ma- 
ke, welches  Unix-kompatibel  ist.  Der  Quelltext-Debugger  macht  auBerdem  das  Suchen 
von  Fehlern  zum  Kinderspiel.  Das  Einrichten  der  Entwicklungsumgebung  beschrankt 
sich  hier  auf  das  Uberspielen  einer  Datei.  Sie  kopieren 

A:\GEMDOS\LASER_C\MAKEFILE  ->  D:\SCRAP 

Wenn  Sie  nun  den  Laser  C starten,  miissen  Sie  zunachst  die  Make-Datei  laden,  indem 
Sie  im  Menii  „Make“  den  Meniipunkt  „Set  Make.,.“  anwahlen.  Dann  erscheint  eine 
Dateiauswahi-Box.  Dort  suchen  Sie  nach  D:\SCRAP\MAKEFILE  und  wahlen  es  aus. 
Nachdem  die  Datei  geladen  wurde,  wahlen  Sie  im  Menii  „Make“  den  Meniipunkt  „M 
scrap. prg“  an.  Nun  wird  die  komplette  Applikation  „gemacht“.  Zum  Starten  wahlen  Sie 
unter  dem  Menii  „Execute“  den  Meniipunkt  „Other...“  aus.  Bei  der  folgenden 
Dateiauswahl-Box  suchen  Sie  SCRAP. PRG  und  klicken  es  doppelt  an. 

Falls  Sie  ein  oder  mehrere  Module  andern,  reicht  es,  immer  wieder  „M  scrap.prg“  anzu- 
wahlen.  Make  garantiert,  daB  alle  Dateien,  die  betroffen  sind,  immer  wieder  neu  compi- 
liert  werden.  Voraussetzung  ist,  daB  das  Datum  und  die  Uhrzeit  in  Ihrem  Rechner  richtig 
gesetzt  ist.  Die  Abhangigkeiten,  welche  in  der  Makedatei  fiir  jedes  Modul  definiert  sind, 
ergeben  sich  genau  aus  den  „include“-Anweisungen  in  den  C-Dateien.  Die  Datei 
EVENT. C beginnt  beispielsweise  mit  den  Zeilen 

#include  ’’import. h” 

# include  ’’global. h” 

# include  ’’windows. h” 
ttinclude  ’’desktop. h” 

# include  ’’menu.h” 

# include  ’’export. h” 

# include  ’’event. h” 
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Die  Abhangigkeit  von  „event.o“  in  der  Makedatei  definiert  sich  zu 
event. o:  $(H)  windows. h desktop. h menu.h  event. h 
wobei  $(H)  ein  Makro  ist,  welches  vorher  zu 
H = import. h export. h global. h 
definiert  wurde.  Eingesetzt  ergibt  sich 

event. orimport.h  export. h global. h windows. h desktop. h menu.h  event. h 

Die  Dateien  im  Makro  $(H)  sind  maBgebend  fur  jede  Quelldatei,  da  jede  Quelldatei  von 
ihnen  abhangt.  Die  anderen  Dateien  sind  exakt  die  Dateien,  welche  in  den  „include“- 
Anweisungen  auftreten.  Natiirlich  hangt  „event.o“  auch  von  der  Datei  „event.c“  ab, 
doch  diese  Abhangigkeit  ist  implizit  und  muB  nicht  speziell  definiert  werden. 

In  der  Makedatei  konnen  auBerdem  noch  Compileroptionen  (CFLAGS)  und  Linkeroptio- 
nen  (LFLAGS)  definiert  werden,  die  jedoch  hier  ohne  Bedeutung  sind  (siehe  jedoch  Mark 
Williams  C). 

c)  Lattice  C 

Fiir  das  Arbeiten  mit  dem  Lattice  C-Compiler  (ab  Version  3.04)  kopieren  Sie 

A:\GEMDOS\LATTICE\SCRAP.LNK  ->  D:\SCRAP 

Am  besten  stellen  Sie  auch  als  Linker  den  schnellen  FLINK  ein,  indem  Sie  in  der  Datei 
MENU. INF  die  Zeile 

LINK  = FLINK  (path)\(file)  [linker_opts]  ? WAIT  : WAIT 
aufnehmen,  d.h.  LINK  durch  FLINK  austauschen. 

Vor  dem  Compilieren  miissen  Sie  die  Compiler-  und  Linkeroptionen  andem.  Starten  Sie 
die  Shell  MENU-I-.PRG  und  gehen  Sie  im  Menu  „Options“  auf  den  Meniipunkt 
„PHASEl_OPTS“.  Tragen  Sie 

-n  -I[path)\  -I..\HEADERS\ 

ein.  Dies  garantiert,  daB  alle  Include-Dateien  gefimden  werden.  Ebenso  andern  Sie  die 
Linker-Optionen  unter  dem  Menupunkt  „LINKER_OPTS“  und  tragen 


-with  SCRAP. LNK  -debug  -nolist 
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ein.  Zum  Compilieren  eines  Moduls  wahlen  Sie  dieses  zunachst  aus.  Das  geschieht  iiber 
das  Menu  „File“  und  den  Meniipunkt  „Choose  C“.  Daraufhin  w^len  Sie  mittels  der 
Dateiauswahl-Box  die  C-Quelldatei  aus.  Dann  starten  Sie  den  Compiler  iiber  den  Menii- 
punkt  „COMPILE“  im  Menii  „Tools“.  Nachdem  Sie  auf  diese  Weise  alle  Module  uber- 
setzt  haben,  mussen  Sie  noch  linken.  Dazu  wahlen  Sie  die  Datei  SCRAP. H iiber  den  Me- 
niipunkt „Choose  H“.  Der  Grund  dafur  liegt  darin,  daC  die  ausfiihrbare  Programmdatei 
den  gleichen  Rumpf  bekommt,  wie  die  ausgewahlte  Datei,  also  SCRAP.  Dann  wahlen 
Sie  „LINK“  im  Menii  „Tools“.  Nach  dem  Linken  konnen  Sie  das  Beispielprogramm  star- 
ten,  indem  Sie  den  Meniipunkt  „RUN  PROGRAM"  im  Menii  „Tools“  aufrufen. 


d)  Mark  Williams  C 

Dem  Mark  Williams  C-Compiler  (ab  Version  3.0.9)  merkt  man  schnell  an,  daB  er  aus 
dem  Unix-^nlichen  Betriebssystem  Coherent  stammt.  Fiir  den  Entwickler  bedeutet  dies, 
daB  er  keine  Probleme  hat,  damit  zu  arbeiten,  wenn  er  sich  in  Unix  auskennt.  Der  Vorteil 
der  Entwicklungsumgebung  liegt  eindeutig  im  Bereich  des  Unix-kompatiblen  Make- 
Mechanismus.  Wie  beim  Laser  C (s.o.)  beschrankt  sich  das  Einrichten  der  Entwicklungs- 
umgebung auf  das  Uberspielen  von  zwei  Dateien.  Sie  kopieren 

A:\GEMDOS\MW_C\MAKEFILE  ->  D:\SCRAP 
A:\GEMDOS\MW_C\STRING.H  ->  C:\MWC\INCLUDE 

Die  Datei  STRING. H ist  eine  von  uns  entwickelte  Headerdatei,  in  der  die  „Prototypen“ 
der  String-  und  Memory-Funktionen  aufgefuhrt  sind.  Diese  Datei  wird  in  IMPORT. H 
verlangt,  und  der  Mark  Williams  Compiler  gehort  zu  den  wenigen  Compilem,  die  diese 
Headerdatei  noch  nicht  in  ihr  Repertoire  aufgenommen  haben.  In  unserem  Beispiel  gehen 
wir  davon  aus,  daB  der  Mark  Williams  Compiler  auf  Laufwerk  C in  dem  Ordner  MWC 
eingerichtet  wurde.  Dort  befmdet  sich  auch  der  Ordner  INCLUDE  fur  die  Headerdateien. 

Die  Makedatei  ist  vollstandig  kompatibel  zum  Laser  C,  so  daB  Sie  das  dort  Gesagte  nach- 
lesen  sollten.  Lediglich  die  beiden  Flags  CFLAGS  zum  Compilieren  und  LFLAGS  zum 
Linken  sind  hier  verschieden.  Sie  lauten 

CFLAGS  = -VPEEP 
LFLAGS  = -X  -s  -laes  -Ivdi 


Fiir  den  Compiler  wird  also  der  Peephole-Optimizer  eingeschaltet.  Diese  Option  hat  erst 
ab  Version  3.x  ihre  Giiltigkeit.  Besitzen  Sie  eine  altere  Version,  so  mussen  Sie  CFLAGS 
auf  leer  setzen.  Beim  Linken  werden  die  globalen  Symbole  sowie  die  Symboltabelle  ent- 
fernt  (-x  -s)  und  die  Bibliotheken  von  AES  und  VDI  hinzugelinkt.  Man  hatte  das  auch 
durch  die  Compileroption  -VGEM  erreichen  konnen,  jedoch  wird  dann  ein  anderes 
Startup-Modul  benutzt.  Der  Linker  soil  aber  das  von  uns  modifizierte  CRTSO.O  benut- 
zen,  da  dieses  wiederum  fahig  ist,  Applikationen  und  Accessories  gleichzeitig  zu 
handhaben. 
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Das  Ubersetzen  von  SCRAP  geschieht  nun  nach  dem  Starten  von  MSH.PRG  dadurch, 
daft  zunachst  in  das  richtige  Inhaltsverzeichnis  gewechselt  werden  muB.  Sie  geben 

cd  d:\scrap 

ein.  Danach  geniigen  die  vier  Buchstaben  „make“  und  die  Applikation  wird  hergestellt. 
Nach  dem  Linken  konnen  Sie  das  Programm  durch  den  Aufruf 

gem  scrap 

starten. 

e)  Turbo  C 

Der  Turbo  C-Compiler  (ab  Version  1.0)  ist  der  einzige  ANSI-C-Compiler  auf  dem  Atari 
ST.  Er  gehort  zu  den  schnellsten  Compilern  und  erzeugt  den  absolut  besten  Code.  Seine 
Entwicklungsumgebung  ist  als  herausragend  zu  bezeichnen.  Allerdings  fehlt  noch  ein  gu- 
ter  Debugger.  Auch  hat  er  kein  Make,  aber  dafiir  besitzt  er  etwas  Ahniiches.  Hier  gibt 
es  die  sogenannten  Projektdateien.  Es  geniigt  das  Uberspielen  einer  Datei,  namlich 

A:\GEMDOS\TURBO_C\SCRAP.PRJ  ->  D:\SCRAP 

Starten  Sie  TC.PRG  und  wahlen  Sie  im  Menii  „Projekt“  den  Meniipunkt  „Select...“  aus. 
Damit  konnen  Sie  iiber  eine  Dateiauswahl-Box  die  Projektdatei  SCRAP.  PRJ  auswahlen. 
Zum  Compilieren  und  Linken  wahlen  Sie  nur  noch  „Make  SCRAP. PRJ“  aus  dem  Menii 
„Projekt“  aus.  Aus  dem  gleichen  Menii  konnen  Sie  auch  sofort  „Run  SCRAP.PRJ“  aus- 
wahlen. Dann  wird  nach  dem  Compilieren  und  Linken  das  Programm  sofort  gestartet. 

Fur  alle  Compiler  unter  Ataris  GEMDOS  gilt  noch  eine  weitere  Regel.  Alle  Make-  und 
Projektdateien  erzeugen  am  Ende  das  Programm  SCRAP. PRG.  Soil  das  Programm  als 
Accessory  gestartet  werden,  so  ist  es  lediglich  von  SCRAP. PRG  auf  SCRAP.  ACC  umzu- 
benennen.  Danach  mufi  es  auf  die  Bootdiskette  Oder  die  Boot-Partition  kopiert  werden. 
Es  erkennt  beim  Booten  automatisch,  daB  es  nun  ein  Accessory  ist  und  reagiert  entspre- 
chend.  Mit  alien  oben  genannten  Compilern  auBer  dem  Lattice  C ist  es  auBerdem  noch 
moglich,  das  Programm,  auch  wenn  es  bereits  auf  SCRAP.  ACC  umbenannt  wurde,  vom 
Desktop  aus  zu  starten.  Dazu  muB  allerdings  die  Zeile 

#G  03  FF  *.ACC@  @ 

in  die  Datei  DESKTOP. INF  aufgenommen  werden.  Dann  werden  alle  Accessories  nam- 
lich ebenfalls  durch  Programm-Piktogramme  angezeigt.  Sie  konnen  dann  ebenfalls  ge- 
startet werden.  Durch  entsprechende  Abfragen  in  den  Startup-Dateien  der  Compiler  ist 
es  moglich,  ein  solches  Accessory  auch  als  Programm  richtig  ablaufen  zu  lassen. 

Fur  MS-DOS  ist  die  Entwicklung  von  Accessories  wegen  des  begrenzten  Speicherraums 
von  640K  nicht  sinnvoll.  Fiir  OS/2  und  FlexOS  bei  Verwendung  von  X/GEM  sind  die 
Zeiten  der  Accessories  wegen  der  Multitasking-Umgebung  gliicklicherweise  vorbei  — 
man  benotigt  sie  nicht  mehr. 
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6.4.2  MS-DOS 

Fiir  das  populare  Betriebssystem  von  Microsoft  haben  wir  zwei  Compiler  ausgewahlt, 
mit  dem  die  Beispielapplikation  ablauffahig  ist.  Auf  jeden  Fall  bendtigen  Sie  aber  das  Pro- 
grammer’s Toolkit  von  Digital  Research,  manchmal  auch  einfach  PTK  genannt.  Zu  die- 
sem  Toolkit  werden  neben  dem  Resource-Construction-Set  und  anderen  Utilities  auch  die 
Quellen  der  Bindings  fiir  die  diversen  Bibliotheken  mitgeliefert, 

Gliicklickerweise  ist  das  Installieren  des  PTK  von  nun  an  ein  Kinderspiel.  Wahrend  man 
friiher  die  Bindings  noch  selbst  an  den  jeweiligen  Compiler  anpassen  muBte,  wurden  sie 
nun  so  umgeschrieben,  dab  sie  mit  verschiedenen  Compilern  arbeiten.  Dies  haben  wir 
der  hervorragenden  Arbeit  von  Robert  Schneider  zu  verdanken,  der  in  der  deutschen 
Tochter  von  Digital  Research  GmbH  in  Miinchen  fur  den  technischen  Support  zustandig 
ist.  Mit  Hilfe  eines  GEM-Programms  klickt  man  sich  nur  noch  durch  die  Installierung 
und  mufi  am  Ende  lediglich  noch  ein  MAKELIB  eingeben,  dann  werden  die  kompletten 
Bibliotheken  aus  den  Bindings  erstellt. 


a)  Microsoft  C 

Der  Microsoft  C-Compiler  (inzwischen  in  der  Version  5.1)  ist  sicher  einer  der  Compiler 
mit  der  besten  Codeerzeugung.  Er  ist  allerdings  nicht  besonders  schnelt.  Auch  er  besitzt 
ein  Make,  das  sich  von  den  Make-Programmen  unter  Unix  etwas  unterscheidet.  Drei  Da- 
teien  sollten  Sie  iiberspielen,  und  zwar 

A:\MSDOS\MS_C\MK.BAT  ->  D:\SCRAP 
A:\MSDOS\MS_C\MAKEFILE  ->  D:\SCRAP 
A:\MSDOS\MS_C\SCRAP.LNK  ->  D:\SCRAP 

Die  Datei  MK.BAT  besteht  eigentlich  nur  aus  einer  Befehlszeile.  Sie  lautet 
make  makefile 

Beim  Microsoft  Make  muB  immer  die  Makedatei  angegeben  werden.  Ein  einfaches 
make 

wie  unter  Unix  reicht  hier  nicht.  Es  ist  viel  einfacher  „mk“  einzugeben,  als  „make  make- 
file" (2  Buchstaben  gegeniiber  dreizehn). 

Die  Makedatei  entspricht  ungefahr  den  Unix-Konventionen.  Allerdings  muB  man  hier 
mehr  Leerzeilen  einfiigen.  AuBerdem  gibt  es  keine  (externe)  implizite  Regeln.  Sie  muB 
man  in  der  Make-Datei  einfiigen.  So  wird  dort  die  Regel 

. c . ob j : 

cl  -c  $(CFLAGS)  $*.c 
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aufgefuhrt,  die  angibt,  wie  eine  C-Datei  in  eine  OBJ-Datei  iiberfiihrt  warden  muB.  Die 
Compiler-  und  Linker-Flags  lauten  hier 

CFLAGS  = -AL  -Oas  -Gs 

LFLAGS  = /ST:  12288  /SE:512  /NOI  /E 

APR  = .app 

Der  Compiler  wird  dadurch  dazu  gebracht,  im  Large-Modell  zu  ubersetzen  und  die  Code- 
groBe  zu  optimieren  (alias-checking  off,  size  optimization,  stack  checking  off) 

Bei  den  Linkflags  warden  die  StackgroBe  (hier  12  KB  = 12288  Bytes)  und  die  Anzahl 
der  Segmente  (hier  512)  angegeben.  AuBerdem  soil  der  Linker  GroB-  und  Kleinschrift 
unterscheiden  (NOI)  und  die  entstehende  Datei  packen  (E). 

Das  fertige  Programm  tragt  das  Suffix  „.app“,  wird  also  „scrap.app“  heiBen.  Dies  ist 
die  iibliche  Konvention  fiir  GEM-Applikationen. 

Falls  es  passiert,  daB  der  Speicher  fiir  eine  groBe  Applikation  nicht  mehr  ausreicht,  muB 
ein  anderer  Linker  herangezogen  warden,  der  auch  verschachtelte  Overlays  zulaBt.  Ein 
solcher  Linker  ist  der  PLINK86.  Er  erwartet  natiirlich  eine  andere  Link-Control-Datei. 

In  der  Makedatei  miiBte  man  dann  die  Zeile 

link  $(LFLAGS)  @$(NAME).lnk 


durch 


plink86  @$(NAME).pl 

ersetzen,  falls  die  Link-Control-Datei  das  Suffix  „pl“  aufweist. 

Das  Compilieren  und  Linken  geschieht  nun  einfach  durch  Eingabe  von  „mk“.  Damit  war- 
den das  Make  gestartet  und  die  Datei  SCRAP. APP  hergestellt.  Ein  Starten  des  Pro- 
gramms  ist  vom  Desktop  aus  moglich,  wobei  die  Datei  doppelt  angeklickt  wird.  Eine  an- 
dere Mdglichkeit  ist  die  Eingabe  von 

gem  scrap 

Dann  wird  die  Applikation  „scrap“  statt  des  Desktops  gestartet.  Dazu  muB  sich 
SCRAP. APP  aber  im  Ordner  GEMAPPS  befinden,  und  zwar  auf  der  Partition  der  Fest- 
platte,  auf  der  sich  das  GEM-System  befindet. 
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b)  Turbo  C 

Fiir  den  Turbo  C-Compiler  (ab  Version  1.5)  haben  wir  zwei  Moglichkeiten  eingeplant. 
Zum  einen  kann  man  in  der  integrierten  Entwicklungsumgebung  arbeiten.  Dort  hat  man 
einen  rasant  schnellen  Turn-around-Zyklus.  Compilieren,  Fehler  verbessern  und  linken 
geschieht  mit  atemberaubender  Schnelligkeit.  Es  gibt  aber  auch  einen  Stand-alone  Com- 
piler und  -Linker,  die  zusammen  mit  einem  Make  eine  ebenfalls  starke  Entwicklungsum- 
gebung bieten.  In  folgenden  Beispielen  wollen  wir  davon  ausgehen,  da6  sich  der  Turbo 
C-Compiler  auf  der  Festplatte  C im  Ordner  \TC  befindet.  Fur  die  integrierte  Umgebung 
iiberspielen  Sie 

A:\MSDOS\TURBO_C\SCRAP.PRJ  ->  D:\SCRAP 
A:\MSDOS\TURBO  CXTCCONFIG.TC  ->  D:\SCRAP 

Die  Datei  SCRAP. PRJ  gibt  die  Projektdatei  an.  Sie  enthalt  alle  Dateinamen  von  SCRAP 
und  den  Namen  „LTCGEM.LIB“  (GEM-Bibliothek  aus  dem  PTK).  Die  Datei  TCCON- 
FIG.TC  enthalt  Einstellungen  der  integrierten  Umgebung.  So  wird  beispielsweise  das 
Stack-Checking  abgeschaltet,  da  sonst  die  benutzerdefmierten  Objekte  nicht  richtig  arbei- 
ten. Auflerdem  werden  bestimmte  Warnmeldungen  unterdriickt,  die  hier  keine  Bedeutung 
haben. 

Das  iibersetzen  und  Linken  geschieht  nun  folgendermaBen;  Starten  der  Turbo  C Um- 
gebung durch  Eingabe  von 

tc 

Dann  mull  die  Projektdatei  geladen  werden.  Dies  geschieht  iiber  den  Meniipunkt  „Projekt 
name"  im  Menu  „Projekt“.  Anschlieflend  kann  die  Funktionstaste  F9  gedriickt  werden. 
Nun  wird  die  Datei  SCRAP.  APP  hergestellt.  Falls  ein  Fehler  auftritt,  kann  sofort  auf  die 
entsprechende  Stelle  gesprungen  werden.  Wird  eine  Datei  geiindert,  reicht  das  Driicken 
von  F9  zum  erneuten  Compilieren  und  Linken.  Das  Starten  ist  aus  der  integrierten  Umge- 
bung nicht  moglich,  da  zuerst  GEM  aufgerufen  werden  muH.  Nach  Verlassen  der  Umge- 
bung iiber  Alt-X  kann  der  GEM-Desktop  aufgerufen  und  das  Programm  von  dort  gestartet 
werden.  Wie  auch  schon  oben  erwahnt,  ist  aber  auch  ein  Aufruf  von 

gem  scrap 

moglich.  Auch  hier  muB  sich  SCRAP. APP  im  Ordner  GEMAPPS  befinden. 

Die  zweite  Moglichkeit  der  Programmerstellung  ist  iiber  einen  Make-Mechanismus  ge- 
geben.  Dazu  iiberspielen  Sie 

A:\MSDOS\TURBO_C\MAKEFILE  ->  D:\SCRAP 
A:\MSDOS\TURBO_C\SCRAP.LNK  ->  D:\SCRAP 
A:\MSDOS\TURBO  CXBUILTINS.MAK  ->  CATC 
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Die  Makedatei  entspricht  der  Unix-Konvention,  so  dal5  Sie  oben  unter  GEMDOS  die  Er- 
klarungen  zum  Laser  C lesen  sollten.  Die  Compiler-  und  Linkerflags  lauten  hier 

CFLAGS  = -ml  w-par 


LFLAGS  = /c  /x 

Der  Compiler  iibersetzt  alle  Dateien  im  Large-Modell.  Dabei  wird  die  Warnung  fur  nicht- 
benutzte  Parameter  abgeschaltet. 

Der  Linker  wird  dazu  gebracht,  GroB-  und  Kleinbuchstaben  zu  unterscheiden  (c  = case 
significant)  und  keine  Mapdatei  zu  erzeugen  (x). 

Beim  Linken  lautet  die  Regel 

$(NAME)$(APP) : $(0BJS) 

tllnk  ${LFLAGS)  @$(NAME).lnk 

Es  wird  also  der  Turbo  Linker  „tlink“  aufgerufen.  Er  holt  sich  die  Namen  der  zu  linken- 
den  Dateien  aus  „scrap.lnk“  (NAME  = scrap). 

Die  Datei  BUILTINS.MAK,  die  Sie  oben  ebenfalls  iiberspielt  haben,  gibt  die  implizite 
Rege!  an,  die  benutzt  werden  soil,  um  eine  C-Datei  in  eine  Objekt-Datei  iiberzufuhren. 
Sie  muB  sich  auf  demselben  Inhaltsverzeichnis  wie  das  Programm  MAKE.EXE  befinden 
(hier  CATC).  Der  Inhalt  lautet 

•c.obj : 

tcc  -c  $(CFLAGS) 

.asm.obj : 
tasm  /mx 

Um  also  eine  Objektdatei  aus  einer  C-Quelle  zu  erstellen,  wird  der  Turbo  C-Compiler 
„tcc“  aufgerufen.  Er  iibersetzt  nur  (-c),  iibernimmt  aber  die  CFLAGS  aus  der  Makedatei, 
Das  $*  steht  fur  die  aktuelle,  zu  ubersetzende  Datei.  Wird  kein  Suffix  angegeben,  so  wird 
eine  C-Datei  angenommen.  Die  Regei  fur  Assemblerprogramme  (hier  mit  dem  Turbo 
Assembler)  wird  der  Vollstandigkeit  halber  auch  aufgenommen.  Damit  laBt  sich  das 
BUILTINS.MAK  auch  fiir  das  PTK  verwenden,  wo  ja  eine  Assemblerdatei  (FAR- 
DRAW.ASM)  fiir  benutzerdefinierte  Objekte  benutzt  werden  muB. 

Durch  die  Eingabe  von 

make 

wird  nun  der  Mechanismus  gestartet.  Nach  dem  Linken  liegt  die  komplette  Applikation 
vor.  Das  Make  garantiert,  daB  nur  die  Dateien  neu  ubersetzt  werden,  die  auch  wirklich 
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geandert  wurden.  Das  Starten  der  Beispielapplikation  geschieht  dann  wie  oben,  mit  dem 
Unterschied,  daft  man  die  integrierte  Umgebung,  in  der  man  sich  ja  nicht  befindet,  auch 
nicht  verlassen  muB. 


6.4.3  FlexOS 

FlexOS  ist  ein  Multiuser-,  Multitasking-,  Echtzeit-Betriebssystem  von  Digital  Research 
und  das  in  diesem  Augenblick  einzige  System,  auf  dem  X/GEM  komplett  lauft.  Die  Ver- 
sion fiir  OS/2  soil  allerdings  noch  in  1989  folgen.  Die  Applikation  GEMDRAW  w'urde 
bereits  auf  der  CeBIT  ’89  gezeigt.  Fiir  FlexOS  konnte  nur  ein  Compiler  getestet  werden. 

a)  High  C 

Der  High  C-Compiler  von  Metaware  ist  ein  besonders  stronger  ANSI-Compiler.  Beim 
Ubersetzen  unserer  Beispielapplikation  lieC  es  sich  leider  nicht  vermeiden,  sehr  viele 
Warnmeldungen  zu  erhalten.  Der  Grund  dafiir  liegt  darin  zu  suchen,  dab  wir  die  Syntax 
auch  auf  Nicht- ANSI-Compiler  abgestimmt  haben.  In  diesem  Punkt  ist  der  High  C- 
Compiler  zu  strong.  Beispielsweise  erzeugt  folgendes  Programmstiick  (hier  mit  Zeilen- 
nummern)  eine  Warnung: 

1 # include  <portab.h> 

2 

3 WORD  func  (WORD  i) ; 

4 

5 WORD  func  (i) 

6 WORD  i; 

7 [ 

8 ] 

Zunachst  wird  der  Prototyp  der  Funktion  „func“  in  Zeile  3 angegeben.  Dann  folgt  die 
Implementierung,  In  Zeile  5 und  6 werden  die  Parameter  in  der  iiblichen  Form  angege- 
ben. Die  Semantik  ist  aber  die  gleiche.  Trotzdem  behauptet  der  Compiler,  die  Semantik 
aus  Zeile  3 ware  in  den  Zeilen  5 und  6 iiberschrieben  worden.  Der  Compiler  sieht  nur 
folgendes  als  richtig  an: 

1 # Include  <portab.h> 

2 

3 WORD  func  (WORD  i); 

4 

5 WORD  func  (WORD  i) 

6 f 

7 ] 

Diese  Warnmeldungen  kann  man  zwar  abschalten,  jedoch  wird  dann  keine  Garantie  mehr 
Ubernommen,  dab  die  Definition  des  Prototyps  und  die  Definition  der  Funktion  seman- 
tisch  gleich  sind. 
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Ahnliches  gilt  fiir  die  Prototypen  von  statischen  Funktionen  innerhalb  einer  Funktion,  die 
der  Compiler  als  „extern“  deklariert  haben  will.  Tut  man  dies,  so  vertragt  es  sich  jedoch 
auch  nicht  mit  anderen  Compilern.  Mit  den  Warnungen  mud  man  leben.  Die  einzige  Al- 
ternative zum  Beseitigen  ware  das  Umschreiben  aller  Funktionsdefinitionen.  Aber  wehe, 
man  muB  auf  einen  anderen,  eventuell  einen  Nicht-ANSI-Compiler  umsteigen.  Auf  die- 
sem  wiirde  sich  dann  das  Programm  nicht  mehr  ohne  Fehler  iibersetzen  lassen. 

Vor  dem  Compilieren  iiberspielen  Sie 

A:\FLEXOS\HIGH_C\MAKEFILE  ->  D:\SCRAP 

A:\FLEXOS\HIGH_C\SCRAP.INP  ->  D:\SCRAP 

A:\FLEXOS\HIGH_C\SCRAP.PRF  ->  D:\SCRAP 

Das  Make  ist  nicht  ganz  Unix-kompatibel.  So  gibt  es  z.B.  keine  impliziten  Abhiingigkei- 
ten.  Aus  diesem  Grund  muB  fur  jedes  Modul  ein  Makro  angegeben  werden,  welches  den 
Compiler  starlet.  Es  lautet: 

COMPILE  = he  $*.c  ${CFLAGS) 

Damit  wird  der  High  C-Compiler  gestartet.  Die  CFLAGS  sowie  die  LFLAGS  werden 
hier  nicht  bendtigt,  sie  sind  leer.  Der  Compiler  muB  jedoch  vor  der  Benutzung  eingerich- 
tet  werden.  Dazu  gibt  es  das  Hilfsprogramm  MWCONFIG.  Damit  stellt  man  den  Compi- 
ler in  das  Big-Modell  um.  Die  Codeerzeugung  kann  man  auf  80286  stellen,  da  FlexOS 
sowieso  nur  ab  diesem  Prozessor  (und  neueren  Modellen)  lauffahig  ist. 

Beim  Linken  wird  der  „link86“  von  Digital  Research  benutzt.  Damit  ergibt  sich  die  Ab- 
hangigkeit 

$(NAME)$(APP) : $(0BJS) 

link86  $( LFLAGS)  $(NAME) . inp[i] 

Die  Datei  „scrap.inp“  wird  als  Inputdatei  benutzt.  Sie  wurde  oben  schon  iiberspielt  und 
enthalt  vor  allem  den  Initialisierungscode  und  die  X/GEM-Library-Namen.  Sie  sieht  fol- 
gendermaBen  aus: 

scrap[stack[add[4000]]]  = 
xgembig.l86[nose,ll] , 

xgerasrtl.l86[s,li] , 

dosrtl.l86[s,li], 

hcbe.l86[s,li] 

Die  drei  Punkte  stehen  fiir  eigene  Module.  Der  Stack  wird  um  4 KB  erhoht,  falls  rekursi- 
ve  Algorithmen  auftauchen.  Ansonsten  berechnet  der  Compiler  die  StackgroBe.  Es  folgt 
die  X/GEM-Library  fiir  das  Big-Modell,  die  als  erste  gelinkt  werden  muB.  Naeh  den  Mo- 
dulen  folgen  die  Schnittstelle  fur  die  X/GEM  „shared  runtime  library",  die  von  alien  Pro- 
zessen  geteilt  wird,  sowie  die  DOS  „runtime  library"  und  die  High  C Big  Library. 
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Das  Ubersetzen  und  Linken  geschieht  einfach  mit  dem  Aufruf 
make 

Die  gelinkte  Applikation  bekommt  das  Suffix  286.  Danach  kann  entweder  der  X/GEM- 
Desktop  mittels 

xgem 

aufgerufen  werden  und  von  dort  das  Programm  SCRAP. 286  gestartet  werden.  Alternativ 
dazu  kann  auch 

xgem  scrap 

aufgerufen  werden.  Dann  wird  ohne  Laden  des  Desktops  sofort  SCRAP. 286  gestartet. 
Da  sowohl  normale  Programme  als  auch  GEM-Programme  das  gleiche  Suffix  aufweisen, 
unterscheidet  X/GEM  die  Art  des  Programms  dadurch,  daB  es  nach  der  Resource-Datei 
(hier  SCRAP. RSC)  sucht.  1st  sie  nicht  vorhanden  oder  eingebunden,  so  muB  X/GEM  mit- 
geteilt  werden,  daB  es  sich  um  eine  Grafik-Applikation  handelt.  Dies  geschieht  mit  der 
Text-Datei  SCRAP. PRF.  Sie  enthalt  dann  die  Zeile 

GraphicsMode  = True 

Dadurch  wird  sichergestellt,  daB  es  sich  um  eine  Grafik-Applikation  handelt. 

Da  FlexOS  ein  Multitasking-Betriebssystem  ist,  kann  wahrend  des  Compilierens  natiir- 
lich  auch  gleichzeitig  getestet  werden,  indem  einfach  weitere  Konsolen  geoffnet  und 
weitere  Prozesse  gestartet  werden  — ein  Traum  fur  alle  auf  Singletasking-Systemen  pro- 
grammierende  Entwickler. 


6.5  Modulbeschreibung 

Im  folgenden  werden  die  18  Module  der  Beispielapplikation  SCRAP  beschrieben.  Zu  je- 
dem  Modul  wird  zunachst  die  Aufgabe,  dann  die  Schnittstellenbeschreibung  geliefert. 
Diese  befindet  sich  in  der  Datei  mit  dem  Suffix  „H“.  Falls  fur  das  Verstandnis  notwen- 
dig,  werden  auch  interne  Details  der  Schnittstellenfunktionen  beschrieben.  Neben  dem 
Durcharbeiten  dieses  Kapitels  empfiehlt  es  sich  auch,  die  entsprechenden  Quelldateien 
in  einen  Editor  zu  laden  und  parallel  dazu  auf  dem  Monitor  zu  haben.  Als  Alternative 
dazu  konnten  natiirlich  die  Quelldateien  auch  ausgedruckt  werden. 

Zunachst  soil  aber  noch  einmal  auf  die  beiden  Dateien  „import.h“  und  „export.h“  einge- 
gangen  werden.  Die  erste  wird  benutzt,  um  Bezeichner  aus  anderen  Modulen  zu  importie- 
ren,  damit  diese  dem  importierenden  Modul  bekannt  werden.  Die  zweite  dient  dazu,  alle 
Bezeichner  aus  einem  Modul  zu  exportieren.  Ftir  Variablen  wird  hierbei  der  entsprechen- 
de  Speicherplatz  angelegt  (s.o.). 
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/ *»*»»»»»»*»  JHHUf  *»»»»»»**»»*»*»»*»»»#**»»**  * / 


/»  »/ 

/*  IMPORT. H */ 

/*  Datura:  24/05/89  »/ 

/*  */ 


#ifndef  __IMPORT„ 

♦ define  _IMPORT__ 

# Include  <stdio.h> 

# include  <string.h> 

# Include  <portab.h> 

# include  <aes.h> 

♦include  <vdi.h> 

#if  GEMDOS 
♦include  <osbind.h> 

♦define  Mavail()  (LONG)Malloc  (-1L) 

♦ endif 

♦if  MSDOS  1 0S2  I FLEXOS 
♦include  <gerados.h> 

♦Include  <dosbind.h> 

♦ endif 

♦ if  ANSI 

♦include  <stdlib.h> 

♦ else 

♦define  abs(x)  ((x)  < 0 ? -(x)  : (x))  /*  Absolut-Wert  »/ 

♦define  labs(x)  abs  (x)  /*  Langer  Abs-Wert  »/ 

♦ endif 

/»»»*♦»  DEFINES  / 

♦ifdef  GLOBAL 
♦undef  GLOBAL 

♦ endif 

♦define  GLOBAL  EXTERN 

♦ if  LASER_C 
♦define  strchr  index 
♦define  strrchr  rindex 
♦endif 
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#if  HIGH_C 
#lfdef  NULL 
#undef  NULL 
# define  NULL  OL 
#endlf 
#endif 

#ifndef  max 

#define  max(a,b)  (((a)  > (b))  ? (a)  : (b))  /*  Maximum- Funkt Ion  */ 

#deflne  min(a,b)  (((a)  < (b))  ? (a)  : (b))  /*  Minimum  Funktion  */ 

#endif 

# define  odd(i)  ((i)  & l)  /*  ungerade  */ 

#ifdef  PASCAL_DEF 
# define  and 
# define  or 
# define  xor 
# define  not 
# define  div 
# define  mod 

# define  bltand  & 

# define  bltor  1 

# define  bitxor  ^ 

# define  bitnot 

# define  loop  for  (;;) 

#define  exltloop(e)  if  (e)  break 
#define  nextloop(e)  if  (e)  continue 

# define  repeat  do  [ 

#deflne  until(e)  ) while  (!  (e)) 

# define  begin  [ 

# define  end  j 

# define  then 

# define  boolean  BOOLEAN 

# define  Integer  WORD 

# define  longint  LONG 

# define  real  FLOAT 

# define  longreal  DOUBLE 
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# define  type  typedef 

#endlf  /*  PASCAL_DEF  */ 


#ifdef  MODUULDEF 

# define 

AND 

&& 

♦ define 

OR 

1 1 
t 1 

♦ define 

XOR 

AA 

♦ define 

NOT 

I 

♦ define 

DIV 

/ 

♦ define 

MOD 

% 

/*  FQr  Modula-Programmierer  */ 


# define  BITAND  & 

# define  BITOR  1 

# define  BITXOR  ^ 

# define  BITNOT 

# define  LOOP  for  (;;) 

# define  EXITLOOP(e)  if  (e)  break 
# define  NEXTLOOP(e)  if  (e)  continue 


♦define  REPEAT 

do  ( 

♦define  UNTIL(e) 

] while  (!  (e)) 

♦define  BEGIN 

[ 

♦define  END 

] 

♦define  WHILE(e) 

while  ( 

e)  ( 

♦define  IF(e) 
♦define  THEN 

if  (e) 

{ 

♦define  ELSE 

j else 

1 

♦define  ELSIF(e) 

] else 

if  (e)  [ 

♦define  CASE(e) 
♦define  OF 

switch 

(e)  [ 

♦define  RETURN 

return 

♦define  INTEGER 

WORD 

♦define  LONGINT 

LONG 

♦define  CARDINAL 

UWORD 

♦define  LONGCARD 

ULONG 

♦define  REAL 

FLOAT 

♦define  LONGREAL 

DOUBLE 

♦define  BITSET 

UWORD 

♦define  LONGBITSET 

ULONG 
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# define  TYPE  typedef 

#endlf  /*  MODULA_DEF  */ 

#endif  /»  _IMPORT_  */ 


Zunachst  wird  das  Macro 
IMPORT 

definiert.  Damit  wird  gewahrleistet,  daB  die  Datei  nur  maximal  einmal  vom  Praprozessor 

durchlaufen  wird.  Wird  sie  ein  zweitesmal  eingelesen,  so  ist IMPORT bereits 

definiert,  so  daB  der  Rest  iibersprungen  wird.  Diese  Methode  benutzen  wir  bei  alien  Hea- 
derdateien.  Hat  man  namlich  verschachtelte  include-Anweisungen  in  seinem  Quelltext, 
dann  ist  nicht  mehr  unbedingt  gewahrleistet,  daB  jede  Datei  nur  einmal  komplett  eingele- 
sen wird.  Wird  eine  Headerdatei  jedoch  bfters  eingebunden,  so  hat  der  Compiler  etwas 
dagegen,  wenn  beispielsweise  eine  Deklaration  ein  und  desselben  Typs  mehr  als  einmal 
auftritt. 

Danach  werden  zunachst  fiinf  Standarddateien  eingelesen.  Die  Datei  „stdio.h“  befindet 
sich  auf  dem  Inhaltsverzeichnis  zum  jeweiligen  Compiler,  meist  INCLUDEX.  Dasselbe 
gilt  fur  „string.h“.  Einzige  Ausnahmen  bilden  der  Mark  Williams  C-Compiler  und  der 
Laser  C-Compiler.  Beim  MWC  haben  wir  die  Datei  „string.h“  selbst  erstellt.  Sie  muB, 
wie  bereits  in  6.4.1  beschrieben,  in  das  Verzeichnis  INCLUDEX  des  Mark  Williams 
Compilers  kopiert  werden.  Beim  Laser  C heiBt  die  Datei  falschlicherweise  „strings.h“ 
und  sollte  in  „string.h“  umbenannt  werden,  um  die  Kompatibilitat  zu  gewahrleisten. 

Nun  folgt  die  Datei  „portab.h“,  welche  wesentlich  zur  Portabilitat  zwischen  den 
Compiler-,  GEM-  und  Betriebssystemversionen  beitragt.  Viele  werden  sich  nun  fragen, 
warum  diese  nicht  als  erstes  eingebunden  wurde.  Der  Grund  dafiir  liegt  in  der  Definition 
von  NULL,  die  in  manchen  „stdio“-Dateien  definiert  ist,  in  anderen  wieder  nicht.  Die 
Definition  aus  „stdio.h“  soil  aber  bevorzugt  behandelt  werden,  da  diese  eventuell  anders 
lautet.  So  ist  NULL  manchmal  als 

# define  NULL  OL 
Oder  als 

# define  NULL  ((void  *)0) 

definiert.  Wiirde  zuerst  „portab.h“,  dann  „stdio.h“  eingelesen,  so  wtirden  manche  Com- 
piler diese  Umdefinition  als  Warnung  oder  Fehler  ansehen,  da  sie  - zumindest  literal 
gesehen  - nicht  gleich  ist.  Beim  High  C-Compiler  von  Metaware  ist  dies  ein  Problem, 
weswegen  fur  ihn  das  NULL  noch  umdefiniert  wird  (s.u.). 
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Es  folgen  die  Headerdateien  „aes.h“  und  „vdi.h“  mil  all  ihren  Definitionen  und  Proto- 
typen.  Natiirlich  konnte  man  diese  auch  weglassen,  falls  man  keine  GEM-Applikation 
schreibt.  Wir  gehen  aber  davon  aus,  dab  es  sich  um  GEM-Applikationen  handelt  und  le- 
sen  die  beiden  Dateien  immer  ein. 

Nun  folgt  ein  betriebssystemabhangiger  Teil.  Fiir  GEMDOS  (Atari  ST)  wird  „osbind.h“ 
eingelesen,  in  welchem  Betriebssystemaufrufe  definiert  sind.  Diese  Datei  existiert  fiir  je- 
den  Compiler.  Einzige  Ausnahme  bildet  der  Turbo  C-Compiler,  welcher  die  Datei  leider 
„tos.h“  genannt  hat.  Das  liegt  daran,  daJl  sich  die  Entwickler  nicht  an  bereits  giiltige 
Standards  gehalten  haben,  sondern  offensichtlich  eigene  Standards  kreieren  wollen.  Um 
nicht  standig  zwischen  den  Compilern  unterscheiden  zu  miissen,  sollten  Sie  das  „tos.h“ 
in  „osbind.h“  umbenennen.  Zusatzlich  wird  das  Makro  „Mavail“  definiert,  welches  den 
verfiigbaren  Speicher  zuriickgibt.  Dies  existiert  bei  MS-DOS  und  FlexOS  (dos_avail), 
so  dab  wir  es  hier  mit  aufgenommen  haben. 

Fur  MS-DOS,  OS/2  und  FlexOS  werden  die  Dateien  „gemdos.h“  und  „dosbind.h“  ein- 
gebunden.  In  „dosbind.h“,  welches  zum  Programmer’s  Toolkit  gehort,  finden  sich  ver- 
schiedene  Betriebssystemaufrufe.  Sie  entsprechen  zum  grobten  Teil  den  entsprechenden 
GEMDOS- Aufrufen.  Ein  Problem  liegt  nun  darin,  dab  diese  Routinen  andere  Bezeich- 
nungen  und  teilweise  auch  eine  andere  Parameterreihenfolge  haben.  Um  nun  die  Quellen 
der  Programme  unveribdert  auf  andere  Rechner  ubernehmen  zu  konnen,  miissen  wir  fol- 
gende  Forderungen  stellen: 

a)  Es  werden  nur  Routinen  benutzt,  die  auf  alien  Rechnern  zur  Verfiigung  stehen. 

b)  Es  werden  nur  die  Bezeichner  der  Routinen  eines  Rechners  bzw.  eines  Betriebs- 
sy stems  benutzt. 

Der  Forderung  a)  kann  nachgekommen  werden,  da  die  Routinen  im  GEMDOS,  MS-DOS 
und  FlexOS  grobtenteils  identisch  sind.  Alle  Routinen,  die  man  benotigt,  findet  man  ent- 
weder  in  „osbind.h“  oder  „dosbind.h“.  Auf  Routinen  wie  z.B.  fiir  Tastatureingabe  oder 
Bildschirmausgabe  kann  man  getrost  verzichten,  da  man  fiir  diesen  Fall  die  GEM- 
Routinen  benutzen  kann.  Ein  iibriges  tun  die  Compilerbibliotheken,  sofern  in  diesen  auf 
jedem  Rechner  die  gleichen  Routinen  implementiert  sind.  Dies  gilt  zumindest  fiir  die 
ANSI-Compiler. 

Um  Forderung  b)  zu  erfiillen,  miissen  wir  uns  entscheiden,  ob  wir  die  GEMDOS-  oder 
DOS-Namen  benutzen.  Wegen  der  groben  Verbreitung  von  GEM  auf  dem  Atari  ST  haben 
wir  uns  fiir  die  GEMDOS-Namen  entschieden.  Dies  bedeutet,  dab  wir  zum  Beispiel  zum 
Lesen  des  Inhaltsverzeichnisses  die  Routinen  „Fsfirst“  und  „Fsnext“  statt  „dos_sfirst“ 
und  „dos_snext“  verwenden. 

Da  die  Benutzung  der  Bezeichner  „Fsfirst“  und  „Fsnext“  aber  beim  Linken  unter  MS- 
DOS  zu  undefmierten  Symbolen  fiihren  wiirden,  miissen  wir  diese  vorher  umdefinieren. 
Aus  diesem  Grand  lesen  wir  die  Datei  „gemdos.h“  ein,  die  samtliche  Funktionen,  die 
in  alien  Betriebssystemen  vorkommen,  so  umdefiniert,  dab  daraus  die  entsprechenden 
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Bezeichner  fur  das  jeweilige  Betriebssystem  werden.  Fur  die  zwei  Aufrufe  „Dgetpath“ 
(dos_gdir)  und  „Fseek“  (dos_lseek)  wurden  in  den  entsprechenden  Makros  auch  die 
Parameter  vertauscht,  da  diese  in  ihrer  Reihenfolge  nicht  ubereinstimmen. 

Sollten  Sie  dennoch  der  Meinung  sein,  lieber  MS-DOS-  statt  GEMDOS-Aufrufe  zu  be- 
nutzen,  weil  Sie  eher  unter  MS-DOS  entwickeln,  so  kbnnen  Sie  dies  ruhig  tun.  Auch  ein 
Mischbetrieb  mit  GEMDOS-  und  MS-DOS  Bezeichnern  ist  moglich.  In  diesem  Fall  mus- 
sen  aber  die  Namen  und  Parameter  fUr  GEMDOS  umdefiniert  werden.  Zu  diesem  Zweck 
haben  wir  die  Datei  „msdos.h“  analog  zu  „gemdos.h“  geschrieben,  die  genau  dies  tut. 
Sie  mull  nur  noch  eingelesen  werden.  Dies  miiBte  an  der  entsprechenden  Stelle  im  „ im- 
port.h“  geschehen,  also  z.B.  direkt  vor  dem  Befehl 

include  <osbind.h> 

Wir  haben  das  hier  nicht  getan,  weil  das  standige  Einlesen  dieser  Datei  unter  GEMDOS 
zusatzliche  Zeit  kosten  wQrde.  AuBerdem  benutzen  die  auf  der  Begleitdiskette  implemen- 
tierten  Module  alle  die  GEMDOS-Namen. 

Nun  wird  bei  ANSI-Compilern  noch  die  Datei  „stdlib.h"  aufgenommen,  in  der  unter  an- 
derem  die  Routinen  „abs“  und  „labs“  definiert  sind.  Fiir  Nicht-ANSl-Compiler  werden 
die  Funktionen  als  Makros  nachdefiniert. 

Es  folgt  die  Definition  von  GLOBAL,  wie  schon  weiter  oben  erklart  wurde.  Fiir  den  La- 
ser C werden  noch  die  beiden  Stringfunktionen  „strchr“  und  „strrchr“  auf  „index“  und 
„rindex“  abgebildet. 

Fiir  den  High  C-Compiler  von  Metaware  wird  das  im  „stdio.h“  definierte  Makro  NULL 
durch  eine  eigene  Definition  ersetzt,  die  fur  alle  Compiler  funktioniert.  Wiirde  man  dies 
nicht  tun,  so  wiirde  man  unberechtigterweise  Fehlermeldungen  bekommen. 

Die  beiden  Makros  „max“  und  „min“  werden  definiert,  falls  dies  nicht  bereits  der  Fall 
ist. 

Das  Makro  „odd“  ist  TRUE,  wenn  eine  Zahl  ungerade  ist,  FALSE  sonst. 

Zum  SchluB  folgen  noch  Definitionen  fiir  Pascal-  und  Modula-Programmierer.  Falls  die- 
se  lieber  ein  „and“  statt  einem  „&&“  schreiben  mochten  oder  „begin“  statt  einem 
sollten  sie  vor  dem  Einlesen  der  Datei  „import.h“  Oder  am  Anfang  dieser  Datei  das 
Makro 


# define  PASCAL_DEF 


bzw. 


^define  MODULA_DEF 
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aufnehmen.  Man  konnte  dies  bei  den  meisten  Compilern  auch  von  auBen  defmieren,  etwa 
durch  die  Compiler-Option  „-D“,  die  bei  den  meisten  Compilern  moglich  ist,  also 

-DPASCAL_DEF 

Falls  die  Makros  nicht  definiert  sind,  werden  die  Pascal-  und  Modula-Definitionen  nicht 
benutzt.  So  spart  man  Zeit  und  Speicherplatz  fur  den  Praprozessor. 

/»»»»*»*»»»****»»**»»*  *»»»»»»»  jnnHHHnnt  »»»»»*»»  »»*»»»»**»»»»»*  / 


/»  */ 

/*  EXPORT. H */ 

/*  Datum:  06/03/89  »/ 

/»  */ 


#lfndef  __EXP0RT__ 

# define  __EXP0RT__ 

#ifdef  GLOBAL 
#undef  GLOBAL 
#endif 

# define  GLOBAL 
#endif  /*  ..EXPORT  _.  »/ 

Die  Datei  „export.h“  besteht  nur  aus  dem  Umdefinieren  des  Schliisselwortes  GLOBAL, 
welches  nun  als  leer  definiert  wird.  Auf  diese  Weise  wird  Speicherplatz  fiir  Variablen 
angelegt,  wie  schon  in  6.2  beschrieben  wurde. 


6.5.1  Modul  GEMAIN 

Wir  beginnen  mit  einem  einfachen  Modul,  welches  nur  eine  einzige  Aufgabe  hat.  Es  stellt 
die  Schnittstelle  zwischen  der  C Run  Time  Library  und  unserer  Applikation  dar.  Wegen 
der  Kiirze  der  Schnittstelle  wollen  wir  diese  hier  komplett  auflisten: 

# if  GEM  8e  XGEM 

GLOBAL  WORD  GEMAIN  _( (VOID) ) ; 

#else 

GLOBAL  WORD  main  .((INT  argc,  BYTE  *argv  [])); 


#endif 
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Normal erweise  heifit  die  Funktion  eines  C-Programms,  die  zuerst  angesprungen  wird, 
„main“.  Wie  oben  zu  ersehen  ist,  wiirde  dies  bei  der  FlexOS-Implementierung  unter 
X/GEM  schiefgehen.  Dort  benutzt  die  X/GEM-Library  das  Symbol  „main“,  um  eigene 
Initialisierungen  vor  dem  Hauptprogramm  durchzufiihren.  Erst  dann  wird  GEMAIN  auf- 
gerufen,  das  Hauptprogramm  einer  X/GEM-Applikation.  Wie  auflerdem  zu  sehen  ist, 
besitzt  es  keine  Parameter. 

Der  C-Quelltext  des  Moduls  GEMAIN  soil  bier  auch  abgedruckt  werden,  da  er  sehr  kurz 
ist  und  zum  Verstandnis  beitragt. 


/*  »/ 
/*  Moduli  GEMAIN. C */ 


/*  Datum: 
/* 


27/05/89 


*/ 

*/ 


4t include  " import. h" 
# include  "global. h" 


# include  "initerm.h" 
# Include  "event. h" 


# include  "export. h" 
# include  "gemain.h" 


DEFINES  *»»x»******5H(***x»»**x****x***iex*x*******»**iHt****»* / 

/XXX***  TYPES  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx****/ 

/xxxxxx  VARIABLES  xxx*****xxxxxxxxx*x*x*xxkxxxxxxxx*x**xxxxxxxx»*xxx / 

#if  GEMDOS 
#if  MW.C 

LONG  _stksize  = 12288;  /*  12  KBytes  Stack  ftir  Mark  Williams  C */ 

#endif 

#endif 

#lf  MSDOS 
#lf  TURBO.C 

DWORD  ^stklen  = 12288;  /*  12  KBytes  Stack  fiir  Turbo  C */ 

#endif 

#endif 
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FUNCTIONS  ^t#*^t************»*5***********it**»»»*)t*******»***** / 

#if  GEM  & XGEM 

GLOBAL  WORD  GEMAIN  () 

[ 

if  (Init^inlterm  (0,  NULL))  hndl_events  {); 
term^inlterm  (); 
return  (0) ; 

] /*  GEMAIN  */ 

#else 

/»***iHt******#^Ht*******»»*»**»******jHHt*»**»*************iHHHt*******/ 

GLOBAL  WORD  main  (argc,  argv) 

INT  argc ; 

BYTE  *argv  []; 

[ 

if  ( init_initerm  (argc,  argv))  hndl_events  (); 
term.initerm  (); 
return  (0); 

] /*  main  */ 

#endif 

Zunachst  werden  die  bendtigten  Headerdateien  eingelesen.  Danach  wird  jeweils  fUr  den 
Mark  Williams  C-Compiler  unter  GEMDOS  und  den  Turbo  C-Compiler  unter  MS-DOS 
die  StackgroBe  festgelegt.  Dies  geschieht  hier  iiber  Variablen,  die  vom  Startup-Code  der 
beiden  Compilerbibliotheken  erkannt  werden. 

Das  eigentliche  Hauptprogramm  beginnt  mit  der  Initialisierung  aller  Module  iiber  einen 
Aufruf  von  „init_initerm“.  Dabei  werden  die  Argumente  „argc“  und  „argv“  iiberge- 
ben.  Unter  X/GEM  sind  diese  nicht  verfiigbar,  so  daB  dort  keine  Argumente  (0,  NULL) 
iibergeben  werden.  Dies  ist  aber  nicht  weiter  tragisch,  da  dann  die  Argumente  Qber 
„shel_read“  gelesen  werden. 

Ist  die  Initialisierung  in  Ordnung,  dann  wird  die  Multi-Event-Schleife  iiber  den  Aufruf 
„hndl_events“  (im  Modul  EVENT)  aufgerufen,  in  der  alle  Ereignisse  abgefangen  wer- 
den. Nach  Terminierung  dieser  Funktion  werden  iiber  „term_initerm“  alle  Module  ter- 
miniert.  Am  Ende  wird  noch  ein 

return  (0) 

aufgerufen,  damit  der  Aufrufer  keine  Fehlermeldung  ausgibt. 

Das  Hauptmodul  GEMAIN  ist  unabhangig  von  der  eigentlichen  Aufgabe  der  Applikation, 
sofern  nur  die  Aufrufe  „init_initerm“,  „term_initerm“  und  „hndl_events“  mit  ent- 
sprechenden  Parametern  existieren  und  dazugebunden  werden. 
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6.5.2  Modul  GLOBAL 

GLOBAL  ist  das  zentrale  Modul  der  gesamten  Applikation.  Es  bietet  eine  Menge  vordefi- 
nierter  Konstanten,  Typen  und  Variablen  an,  die  garantiert  in  jeder  GEM-Applikation  im- 
mer  wieder  auftreten.  Dazu  gibt  es  eine  Menge  von  Funktionen,  die  von  jeder  Applikation 
mehr  oder  weniger  gebraucht  werden.  Das  richtige  Benutzen  dieses  Moduls  bietet  auBer- 
deni  die  Garantie  fiir  Kompatibilitat  mit  alien  GEM-Versionen. 

Sollten  Sie  in  ihrer  Applikation  weitere  Routinen  bendtigen,  die  „global“  zu  all  Ihren 
Modulen  sein  sollen,  so  sollten  Sie  das  Modul  GLOBAL  nicht  erweitern,  sondern  ein  Mo- 
dul schreiben,  welches  oberhalb  von  GLOBAL  steht,  d.h.  Routinen  und  Variablen  aus 
GLOBAL  benutzt,  aber  applikationsspezifisch  ist.  Dann  bleibt  GLOBAL  applikations- 
unabhangig,  und  bei  einer  neuen  Version  dieses  Moduls  bzw.  einer  neuen  Auflage  dieses 
Buches  muB  nur  das  Modul  GLOBAL  ausgetauscht  werden,  ohne  dali  Modifikationen  an 
anderen  Modulen  vorgenommen  werden  miissen  (Aufwartskompatibilitat). 

Die  Konstanten  und  Typen  in  GLOBAL. H sind  so  gut  kommentiert,  daB  eine  weitere  Er- 
klarung  bier  uberfliissig  ist.  Das  gleiche  gilt  fiir  die  definierten  Typen.  Es  werden  bier 
nur  noch  die  globalen  Variablen  sowie  alle  Funktionen  erklart.  Die  Funktionen  werden 
jeweils  in  ANSI-Schreibweise  angegeben. 


a)  Globale  Variablen 

#if  DR_C  I LASER.C  I MW_C 
EXTERN  WORD  gl.apidj 
#else 

GLOBAL  WORD  gl.apid; 
#endif 


Die  globale  Applikationsnummer  wird  von  fast  alien  Aufrufen  an  die  Applikations- 
Bibliothek  benotigt.  Je  nach  Compiler  befindet  sie  sich  in  der  AES-Bibliothek  oder  muB 
im  Hauptprogramm  definiert  werden. 

#if  GEM  & {GEMl  I GEM2  ! GEM3) 

GLOBAL  WORD  contrl  [12]; 

GLOBAL  WORD  intin  [256]; 

GLOBAL  WORD  ptsin  [256]; 

GLOBAL  WORD  intout  [256]; 

GLOBAL  WORD  ptsout  [256]; 

#endif 


Die  Felder  fiir  die  Parameter  von  VDI- Aufrufen  werden  bei  X/GEM  nicht  benotigt.  Bei 
einigen  Compilern/Betriebssystemen  miissen  sie  im  Hauptprogramm  definiert  werden, 
bei  anderen  sind  sie  in  der  VDI-Bibliothek  definiert  und  konnen  damit  als  EXTERN  defi- 
niert werden. 
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GLOBAL  WORD  gl.wchar; 

GLOBAL  WORD  gl.hchar; 

GLOBAL  WORD  gl_wbox; 

GLOBAL  WORD  gl.hbox; 

GLOBAL  WORD  gl.wattr; 

GLOBAL  WORD  gl.hattr; 

Die  sechs  Variablen  geben  globale  Attribute  des  Systemzeichensatzes  an.  Die  Variablen, 
die  auf  „char“  enden,  beinhalten  die  Breite  und  Hdhe  eines  Zeichens  aus  dem  Systemzei- 
chensatz.  Diese  Werte  konnen  beim  Aufruf  von  „vst_height“  benutzt  werden,  um  ein 
Zeichen  aus  dem  (groBen)  Systemzeichensatz  darzustellen.  Dabei  gilt  die  Hohe  eines  Zei- 
chens nur  bis  zur  Baseline.  Bei  einem  8xl6-Zeichensatz  waren  die  Werte  z.B.  7x13. 

Die  Variablen,  die  auf  „box“  enden,  geben  die  Breite  und  Hohe  einer  Box  an,  in  die  ein 
Zeichen  des  Systemzeichensatzes  genau  hineinpaBt.  Bei  einem  8xl6-Zeichensatz  waren 
dies  die  Werte  8x16.  Die  Anzahl  der  Pixel  in  X-Richtung  und  Anzahl  der  Pixel  in  Y- 
Richtung  dividiert  durch  diese  beiden  Werte  ergeben  die  Anzahl  der  Spalten  bzw.  Zeilen 
auf  dem  Bildschirm,  also  z.B.  640  / 8 = 80  Spalten  und  400  / 16  = 25  Zeilen. 

Die  Variablen,  die  auf  „attr“  enden,  geben  die  Breite  und  Hdhe  einer  Box  an,  welche 
groB  genug  ist,  um  ein  Attribut  eines  Fensters  zu  umschlieBen.  Attribute  von  Fenstern 
sind  z.B.  die  SchlieBbox,  die  VergroBerungsbox  usw.  Diese  Werte  werden  benutzt,  wenn 
es  um  die  Darstellung  des  Scrollbalkens  der  Menuzeile  im  Fenster  geht. 


GLOBAL  WORD  colors; 

Sie  beinhaltet  die  Anzahl  der  Farben.  Wenn  der  Wert  dieser  Variablen  zwei  ist,  kann  man 
z.B.  bestimmte  Muster  fiir  Monochromdarstellung  benutzen,  da  nur  zwei  Farben  exi- 
stieren. 


GLOBAL  WORD  phys_handle; 

Der  durch  „graf_handle“  ermittelte  Wert  der  physikalischen  Workstation. 


GLOBAL  WORD  vdi_handle; 

Der  durch  „open_vwork“  ermittelte  Wert  der  virtuellen  Workstation  fiir  den  Bild- 
schirm. Ist  noch  keine  Workstation  gedffnet,  so  hat  „vdi_handle“  den  gleichen  Wert 
wie  „phys_handle“. 


GLOBAL  BOOLEAN  vwork_open; 

Die  Variable  ist  TRUE,  wenn  die  virtuelle  Workstation  gedffnet  ist,  FALSE  sonst.  Durch 
Abfrage  dieser  Variablen  kann  verhindert  werden,  daB  sie  zweimal  gedffnet  wird  (siehe 
Funktion  „open_vwork“). 
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GLOBAL  BOOLEAN  deskacc; 

Die  Variable  ist  TRUE,  wenn  die  laufende  Applikation  ein  Deskaccessory  ist,  FALSE 
sonst.  Dies  gilt  fUr  aile  Compiler,  auch  solche,  die  keine  externe  Variable  „_app“  in 
ihr  Runtime-Startup  aufgenommen  haben.  Letztere  haben  allerdings  den  Vorteil,  dali  die 
damit  entwickelten  Programme  auch  als  Applikationen  laufen  kdnnen,  obwohl  deren  Na- 
me auf  ACC  endet. 


GLOBAL  BOOLEAN  acc_close; 

Die  Variable  ist  TRUE,  wenn  die  letzte  Meldung  von  „evnt_multi“  ein  AC_CLOSE 
war,  FALSE  sonst.  Es  ist  wichtig,  sich  diesen  Umstand  zu  merken,  da  die  beim 
AC_CLOSE  zu  schlieftenden  Fenster  tatsachlich  nicht  iiber  „wind_close“  bzw. 
„wind_delete“  geschlossen  bzw.  geloscht  werden  diirfen.  Tut  man  dies  trotzdem,  sturzt 
das  GEM  gnadenlos  ab.  Fine  Anwendung  dieser  Variablen  findet  man  in  der  Funktion 
„close_window“  im  Modul  WINDOWS. 


GLOBAL  WORD  menu_id; 

Der  durch  „menu_register“  ermittelte  Wert  des  Meniieintrags  eines  Deskaccessories. 


GLOBAL  WORD  class_desk; 

Die  Variable  erhalt  den  Wert  der  Klasse  des  Desktops.  Sie  ist  entweder  null  (DESK), 
wenn  es  sich  um  einen  eigenen  Desktop  handelt,  oder  eins  (DESKWINDOW),  wenn  der 
Desktop  in  ein  Fenster  gelegt  werden  muB.  Dies  ist  genau  dann  der  Fall,  wenn  es  sich 
um  ein  Accessory  mit  eigenem  Desktop  handelt  oder  wenn  die  Meniizeile  nicht  mehr  auf 
den  Bildschirm  paBt  (z.B.  bei  zu  breiter  Meniizeile  in  der  niedrigen  Auflosung  des  Atari 
ST). 


GLOBAL  RECT  desk; 

Dies  ist  das  Rechteck,  welches  den  Desktop  beschreibt.  Es  ist  iiblicherweise  so  groB  wie 
der  physikalische  Bildschirm,  wobei  vom  oberen  Rand  noch  die  Hohe  der  Meniizeile  ab- 
gezogen  wird. 


GLOBAL  RECT  clip; 

Dadurch  wird  das  Rechteck,  welches  zuletzt  mit  „set_clip“  (s.u.)  gesetzt  wurde,  be- 
schrieben.  Damit  kdnnen  Algorithmen,  die  Fensterinhalte  zeichnen,  optimiert  werden 
(siehe  „wi  draw"  im  Modul  EDIT). 
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GLOBAL  WORD  hidden; 

Die  Variable  zahlt  die  Anzahl  der  Aufrufe  von  „hide_mouse“.  Die  „hide  mouse"  und 
„show_mouse“  Aufrufe  werden  gestackt,  so  daB  immer  eine  korrespondierende  Anzahl 
von  Aufrufen  stattfinden  mufl.  Dadurch  wird  verhindert,  daB  Funktionen,  welche  nicht 
wissen,  ob  die  sie  aufrufenden  Funktionen  ebenfalls  die  Maus  verstecken,  die  Maus  wie- 
der  zeigen,  obwohl  sie  noch  unsichtbar  sein  sollte.  Der  Anfangswert  ist  null. 


GLOBAL  WORD  busy; 

Die  Variable  zahlt  die  Anzahl  der  Aufrufe  von  „busy_mouse“.  Die  „busy_mouse“  und 
,,arrow„mouse“  Aufrufe  werden  gestackt,  so  daB  immer  eine  korrespondierende  An- 
zahl von  Aufrufen  stattfinden  muB.  Dadurch  wird  verhindert,  daB  Funktionen,  welche 
nicht  wissen,  ob  die  sie  aufrufenden  Funktionen  die  Maus  ebenfalls  als  Biene  bzw.  Stun- 
denglas  darstellen,  die  Maus  wieder  als  Pfeil  zeigen,  obwohl  sie  noch  geschaftig  sein  soll- 
te. Der  Anfangswert  ist  null. 


GLOBAL  BOOLEAN  done; 

Die  Variable  ist  TRUE,  wenn  das  Programm  beendet  werden  soil,  FALSE  sonst.  Dies 
ist  iiblicherweise  beim  Wahlen  der  Funktion  „Ende‘‘  der  Fall.  Der  Anfangswert  ist 
FALSE. 


GLOBAL  BOOLEAN  grow_shrink; 

Die  Variable  ist  TRUE,  wenn  beim  Offnen  und  SchlieBen  von  Fenstern  und  Dialogboxen 
ein  sich  ausdehnendes  bzw.  schrumpfendes  Rechteck  gezeichnet  werden  soli,  FALSE 
sonst.  In  unserer  Beispielapplikation  kann  der  Wert  der  Variablen  iiber  eine  Dialogbox 
eingestellt  werden.  Der  Anfangswert  ist  TRUE. 


GLOBAL  BOOLEAN  ring^bell; 

Die  Variable  ist  TRUE,  wenn  bei  Fehlermeldungen  die  Glocke  ertonen  soil,  FALSE 
sonst.  In  unserer  Beispielapplikation  kann  der  Wert  der  Variablen  iiber  eine  Dialogbox 
eingestellt  werden.  Damit  kann  das  eventuell  storende  Piepssignal  abgeschaltet  werden. 
Der  Anfangswert  ist  TRUE. 

GLOBAL  WORD  blinkrate; 

Sie  gibt  die  Anzahl  an,  wie  oft  ein  Meniieintrag  jeweils  invertiert  werden  soil,  bevor  das 
Menii  ausgefuhrt  wird.  Dies  gilt  fiir  Meniizeilen  im  Fenster  und  Pop-Up-Meniis.  In  unse- 
rer Beispielapplikation  kann  der  Wert  der  Variablen  iiber  eine  Dialogbox  eingestellt  wer- 
den. Der  Anfangswert  ist  drei. 
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GLOBAL  STR128  cmd; 

Sie  bezeichnet  den  Namen  des  Kommandos,  durch  welches  das  Programm  gestartet  wur- 
de,  d.h.  den  Namen  des  Programms  selbst,  also  z.B.  SCRAP. PRG.  Der  Wert  wird  iiber 
ein  „shel_read“  ermittelt. 


GLOBAL  STR128  tail; 

Sie  beschreibt  die  Parameter,  die  an  die  Applikation  iibergeben  wurden.  Sie  werden  aus 
„argv“  Oder  iiber  „shel_read“  ermittelt,  falls  „argv“  nicht  gesetzt  ist.  Werden  mehrere 
Parameter  an  das  Programm  iibergeben,  so  werden  diese  jeweils  durch  ein  Leerzeichen 
getrennt.  So  konnen  Parameter  unserer  Beispielapplikation  sein: 

SCRAP.IMG  SCRAP. GEM  SCRAP.TXT 

Es  handelt  sich  also  um  drei  Dateien.  Sie  alle  werden  beim  Starten  der  Applikation  gedff- 
net  (siehe  „init_initerm“  im  Modul  INITERM). 


GLOBAL  STR128  called  by; 

Sie  bezeichnet  den  Namen  des  aufrufenden  Programms,  falls  dieses  seinen  Namen  hinter 
die  Parameter  gehangt  hat  (siehe  auch  Kapitel  5.5).  Dieses  wird  dann  beim  Aufruf  des 
Meniipunktes  „An  ...“  aufgerufen  (siehe  „term_initerm“  im  Modul  INITERM). 


GLOBAL  STR128  app_name; 

Der  Name  der  Applikation,  also  z.B.  SCRAPP.APP  oder  SCRAP. ACC,  wird  hier  ab- 
gelegt. 


GLOBAL  STR128  app_path; 

Der  Pfad  der  Applikation  mit  abschliefiendem  „\“  wird  hier  abgelegt,  also  z.B. 
D:\TMP\SCRAP\ 

falls  eine  Applikation  vom  Inhaltsverzeichnis  \TMP\SCRAP  in  Laufwerk  D:  gestartet 
wurde.  Mit  Hilfe  dieses  Pfades  konnen  Dateien,  die  sich  im  selben  Inhaltsverzeichnis  be- 
finden  sollen  wie  die  Applikation,  leicht  eingelesen  werden.  Nicht  immer  ist  das  aktuell 
eingestellte  Laufwerk  und  der  aktuell  eingestellte  Pfad  derjenige,  auf  welchem  sich  die 
Applikation  befindet.  Dies  umso  mehr,  wenn  eine  Anwendung  angemeldet  wurde,  und 
von  einem  anderen  Laufwerk  das  angemeldete  Piktogramm  angeklickt  wurde.  Durch 
Voranstellen  der  Variable  „app  path"  kann  ein  kompletter  Pfadname  fiir  eine  Datei  ge- 
bildet  werden. 
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GLOBAL  WORD  act  drv; 

Die  Variable  enthalt  das  aktuelle  Laufwerk  beim  Starten  der  Applikation. 


GLOBAL  STR128  act_path; 

Die  Variable  enthalt  das  aktuelle  Inhaltsverzeichnis  beim  Starten  der  Applikation.  Sie  ent- 
halt auch  den  Laufwerksnamen  und  endet  immer  mit  einem  Sie  kann  also  z.B.  den 
Wert 

H:\SCRAP\ 

annehmen.  Falls  ein  Dateiname  ohne  Pfad  an  eine  Applikation  iibergeben  wird,  sollte  der 
Name  mit  Hilfe  dieser  Variablen  erganzt  werden. 


GLOBAL  SIR  128  scrapdir; 

Sie  enthalt  das  Inhaltsverzeichnis  des  GEM-Clipboards.  Es  kann  benutzt  werden,  um  die 
Dateinamen  zu  erfahren,  die  sich  darauf  befinden.  Als  Maske  sollte  ein  SCRAP.*  gewahlt 
werden.  Das  Inhaltsverzeichnis  heilit  CLIPBRD  und  befindet  sich  beim  Atari  auf  der 
obersten  Ebene  eines  schnellen  Laufwerks  (sofern  vorhanden).  Bei  MS-DOS  (ab  GEM/3) 
befindet  es  sich  im  Ordner  GEMAPPS,  so  daB  der  komplette  Pfad  fiir  Laufwerk  C 

C:\GEMAPPS\CLIPBRD\ 

lauten  wiirde.  Eine  Beschreibung  zum  GEM-Clipboard  wurde  schon  in  Kapitel  5 
gegeben. 

GLOBAL  LONGSTR  fs.path; 

GLOBAL  STRING  fs.sel; 

GLOBAL  WORD  fs.button; 

Die  Variablen  geben  den  von  der  Applikation  zuletzt  gewahlten  Zugriffspfad  (fs^path), 
den  zuletzt  gewahlten  Dateinamen  (fs_sel)  und  den  zuletzt  betatigten  Knopf  (fs_button) 
der  Dateiauswahl-Box  an.  Ein  Beispiel  fiir  die  Benutzung  dieser  Variablen  wird  in  der 
Funktion  „select_file“  weiter  unten  gegeben. 

GLOBAL  OBJECT  *raenu; 

GLOBAL  OBJECT  *about; 

GLOBAL  OBJECT  ^desktop; 

GLOBAL  OBJECT  *freetext; 
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Die  vier  Objektbaume  kommen  in  praktisch  jeder  Applikation  vor  und  sind  deshalb  global 
defmiert.  „menu“  gibt  die  Meniizeile  an,  „about“  die  Dialogbox,  welche  durch  das  Menii 
„Uber...“  gewahltwird.  „desktop“  ist  der  eigene  Desktop  und  „freetext“  ist  eine  Dialog- 
box,  in  der  sich  alle  Texte  befinden,  die  zu  keiner  bestimmten  Dialogbox  gehoren.  Alle 
Variablen  werden  auf  NULL  initialisiert  und  miissen  nicht  unbedingt  gesetzt  werden.  Exi- 
stiert  beispielsweise  keine  Meniizeile  Oder  kein  eigener  Desktop,  so  bleiben  die  Variablen 
eben  auf  NULL.  Das  Programm  reagiert  trotzdem  korrekt. 


GLOBAL  BYTE  **alertmsg; 

Die  Variable  zeigt  auf  die  Zeiger  aller  Fehlermeldungen.  Sie  wird  im  Modul  RESOURCE 
initialisiert,  falls  es  iiberhaupt  Fehlermeldungen  gibt.  Die  Variable  wird  benbtigt,  um  die 
Funktionen  „error“  und  „note“  zu  implementieren.  Sie  greifen  dann  auf  die  Fehlermel- 
dungen liber  diese  Variablen  zu. 


b)  Globale  Funktionen 

- Offnen  und  SchlieBen  von  Arbeitsstationen 
VOID  open_vwork  (VOID); 

Offnet  eine  virtuelle  Arbeitsstation  auf  dem  Bildschirm.  Die  Variablen  „vdi_handle“, 
„colors“  sowie  „gl_wchar“  und  „gl_hchar“  werden  gesetzt.  Ist  die  Arbeitsstation 
schon  offen,  so  passiert  nichts. 


VOID  close  V work  (VOID); 

SchlieBt  eine  virtuelle  Arbeitsstation  auf  dem  Bildschirm.  Diese  muB  vorher  mit 
„open  vwork“  gedffnet  worden  sein.  Nach  dem  SchlieBen  wird  das  „vdi  handle"  auf 
„phys  handle"  gesetzt.  Ist  die  Arbeitsstation  bereits  geschlossen,  so  passiert  nichts. 


WORD  open_work  (WORD  device,  DEV  INFO  *dev_info); 

Offnet  eine  Arbeitsstation,  also  z.B.  einen  Bildschirm,  einen  Plotter,  einen  Drucker,  eine 
Metadatei,  eine  Kamera  oder  ein  Grafiktablett. 

open_work:  Handle  der  Arbeitsstation  oder  0,  wenn  das  Offnen  nicht  geklappt  hat. 
device  : Geratenummer,  wobei  gilt: 

SCREEN  = 1 
PLOTTER  = 11 
PRINTER  =21 
METAFILE  = 31 
CAMERA  = 41 
TABLET  = 51 
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Selbstverstandlich  konnen  auch  andere  Nummern  benutzt  werden,  falls  diese  einen  sinn- 
vollen  Wert  enthalten  (z.B.  22  fur  den  zweiten  Drucker) 

dev  info  : Zeiger  auf  eine  Struktur,  die  nach  dem  Aufruf  bestimmte  charakteristische 
Werte  des  Gerats  enthalt.  Die  Struktur  ist  folgendermaBen  aufgebaut; 


typedef  struct 
r 

LONG 

dev_w; 

/* 

LONG 

dev_h; 

/* 

WORD 

plx_w; 

/* 

WORD 

pix_h; 

/* 

Breite  des  Ausgabegerates  in  Pixel  */ 
Hohe  des  Ausgabegerates  in  Pixel  */ 
Breite  eines  Pixels  in  1/1000  mm  »/ 
Hohe  eines  Pixels  in  1/1000  ram  */ 


] DEVINFO; 


Ist  der  Bildsschirm  das  zu  offnende  Gerat,  so  wird  es  virtuell  geoffnet. 


VOID  close_work  (WORD  device,  WORD  out_handle); 

Die  vorher  mit  „open_work“  geoffnete  Arbeitsstation  wird  wieder  geschlossen. 

device  : Geratenummer  (siehe  „open_work“) 

out_handle  : Handle,  welches  durch  „open_work“  geliefert  wurde 


— Mausfunktionen 

VOID  set_mouse  (WORD  number,  MFORM  *addr); 

Die  aktuelle  Mausform  wird  gesetzt. 
number:  Nummer  der  Mausform  (siehe  AES.H) 

addr  : Zeiger  auf  eine  benutzerdefinierte  Mausform,  falls  „number“  den  Wert  255 
(=  USER  DEF)  hat 

Die  Funktion  merkt  sich  die  aktuelle  und  die  letzte  Mausform. 


VOID  last_mouse  (VOID); 

Setzt  die  letzte  Mausform,  die  vor  der  aktuellen  Mausform  giiltig  war.  Damit  kann  z.B. 
die  Routine  fiir  Pop-Up-Meniis  die  alte  Mausform  wiederherstellen,  nachdem  wahrend 
der  Abarbeitung  des  Pop-Up-Meniis  auf  einen  Pfeil  umgeschaltet  wurde. 
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VOID  hide_mouse  (VOID); 

Die  Maus  wird  versteckt.  1st  die  Maus  bereits  versteckt,  passiert  nichts.  Die  Anzahl  der 
Aufrufe  wird  geziihlt,  so  dafi  ein  zweimaliger  Aufruf  von  „hide_mouse“  die  Variable 
..hidden"  auf  2 setzt.  Um  die  Maus  wieder  sichtbar  zu  tnachen,  miissen  entsprechend 
viele  Aufrufe  von  „show_mouse“  erfolgen. 


VOID  show_ mouse  (VOID); 

Die  Maus  wird  sichtbar  gemacht,  wenn  sie  genau  einmal  versteckt  war.  Ansonsten  pas- 
siert nichts.  Wurde  sie  ofter  versteckt,  so  muB  sie  genauso  oft  sichtbar  gemacht  werden, 
damit  sie  erscheint. 


VOID  busy_mouse  (VOID); 

Die  Maus  nimmt  eine  Form  an,  die  anzeigt,  daB  der  Rechner  beschaftigt  ist.  Beim  Atari 
ST  ist  dies  eine  Biene  (BUSY_BEE),  bei  alien  anderen  Rechnern  ein  Stundenglas 
(HOURGLASS).  Hat  die  Maus  bereits  diese  Form,  so  passiert  nichts.  Um  die  Maus  wie- 
der zum  Pfeil  zu  machen,  miissen  entsprechend  viele  Aufrufe  von  „arrow_mouse“  er- 
folgen. 


VOID  arrow_mouse  (VOID); 

Die  Mausform  wird  zum  Pfeil,  wenn  sie  genau  einmal  eine  Biene  bzw.  ein  Stundenglas 
war.  Ansonsten  passiert  nichts.  Durch  die  Zahlung  der  „busy_mouse“-  bzw. 
„arrow_mouse“-Aufrufe  wird  gewahrleistet,  daB  bei  langer  andauernden  Operationen, 
die  eine  beschaftigte  Maus  zeigen  und  in  welchen  Funktionen  aufgerufen  werden,  die  dies 
ebenfalls  tun,  die  Maus  durchgehend  eine  „beschaftigte“  Form  annimmt.  Ohne  Zahlung 
wiirde  sie  vorzeitig  eine  Pfeilform  annehmen,  obwohl  die  Operation  noch  nicht  abge- 
schlossen  ist. 


— Objektfunktionen 

VOID  do_state  (OBJECT  *tree,  WORD  obj,  UWORD  state); 

Die  Komponente  „ob_state“  eines  Objekts  wird  gesetzt. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

state  : Status,  welcher  gesetzt  wird  (siehe  AES.H) 
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VOID  undo_state  (OBJECT  *tree,  WORD  obj,  DWORD  state); 

Die  Komponente  „ob_state“  eines  Objekts  wird  zuriickgesetzt. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

state : Status,  welcher  zuriickgesetzt  wird  (siehe  AES.H) 


VOID  flip_state  (OBJECT  *tree,  WORD  obj,  DWORD  state); 

Die  Komponente  „ob_state“  eines  Objekts  wird  invertiert,  also  z.B.  von  SELECTED 
auf  NOT  SELECTED. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  ; Index  des  Objekts 

state  : Status,  welcher  invertiert  wird  (siehe  AES.H) 


WORD  find  state  (OBJECT  *tree,  WORD  obj,  DWORD  state); 

Die  Objektnummer  eines  Objektes  mit  einem  bestimmten  Status  (z.B.  SELECTED)  wird 
geliefert. 

find_state:  Index  des  Objekts  mit  dem  gesuchten  Status.  Wurde  kein  Objekt  gefunden, 
so  ist  das  Ergebnis  NIL. 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objekts,  bei  welchem  die  Suche  begonnen  wird 
state  : Status,  nach  welchem  gesucht  wird  (siehe  AES.H) 


VOID  do_flags  (OBJECT  *tree,  WORD  obj,  DWORD  flag); 

Die  Komponente  „ob_flags“  eines  Objekts  wird  gesetzt. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

flag  : Flag,  welches  gesetzt  wird  (siehe  AES.H) 


VOID  undo_flags  (OBJECT  *tree,  WORD  obj,  DWORD  flag); 

Die  Komponente  „ob_flags“  eines  Objekts  wird  zuriickgesetzt. 

tree:  Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

flag:  Flag,  welches  zuriickgesetzt  wird  (siehe  AES.H) 
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VOID  flip_flags  (OBJECT  *tree,  WORD  obj,  DWORD  flag); 

Die  Komponente  „ob_flags“  eines  Objekts  wird  invertiert,  also  z.B.  von  SELECT- 
ABLE auf  NON  SELECTABLE. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

flag  : Flag,  welches  invertiert  wird  (siehe  AES.H) 


WORD  find^flags  (OBJECT  *tree,  WORD  obj,  DWORD  flag); 

Die  Objektnummer  eines  Objektes  mit  einem  bestiminten  Flag  (z.B.  SELECTABLE) 
wird  geliefert. 

find  flags:  Index  des  Objekts  mit  dem  gesuchten  Flag.  Wurde  kein  Objekt  gefunden, 
so  ist  das  Ergebnis  NIL. 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objekts,  bei  welchem  die  Suche  begonnen  wird 
flag  : Flag,  nach  welchem  gesucht  wird  (siehe  AES.H) 


VOID  set^ptext  (OBJECT  *tree,  WORD  obj,  BYTE  *s); 

Der  Wert  der  Zeichenkette  eines  Objektes  vom  Typ  G_TEXT,  G_BOXTEXT, 
G_FTEXT,  G_FBOXTEXT  kann  gesetzt  werden.  Ist  die  ubergebene  Zeichenkette  lan- 
ger  als  die  im  Objektbaum  reservierte  Lange,  so  wird  sie  automatisch  auf  die  maximale 
Lange  verkiirzt. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

s : Zeiger  auf  die  Zeichenkette,  die  im  Objekt  gesetzt  werden  soil 


VOID  get_ptext  (OBJECT  *tree,  WORD  obj,  BYTE  *s); 

Der  Wert  der  Zeichenkette  eines  Objektes  vom  Typ  G_TEXT,  G_BOXTEXT, 
G_FTEXT,  G_FBOXTEXT  kann  gelesen  werden. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  ; Index  des  Objekts 

s : Zeiger  auf  die  Zeichenkette,  die  aus  dem  Objekt  gelesen  werden  soli 
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VOID  objc_rect  (OBJECT  *tree,  WORD  obj,  RECT  *rect); 

Die  aktuellen  Koordinaten  des  ein  Objekt  umhullenden  Rechtecks  konnen  bestimmt  wer- 
den.  Das  Ergebnis  bezieht  sich  auf  den  Koordinatenursprung  in  der  linken  oberen  Ecke 
des  Bildschirms  (x  = 0,  y = 0). 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objekts 

reel  : Zeiger  auf  das  resultierende  Rechteck 


VOID  trans  gimage  (OBJECT  *tree,  WORD  obj); 

Die  Icons  und  Bit-Images  eines  Objektbaums  konnen  in  das  geratespezifische  Format  um- 
gewandelt  werden.  Dazu  wird  die  VDI-Funktion  „vr_trnfm“  benutzt. 

tree  : Zeiger  auf  einen  Objektbaum 
obj  : Index  des  Objekts 

Ein  Beispiel  zu  dieser  Funktion  findet  sich  im  Modul  RESOURCE,  wo  alle  Objektbaume 
durchsucht  werden,  um  Icons  und  Bit-Images  zu  transformieren.  Der  Aufruf  ist  nur  dann 
notig,  wenn  das  geratespezifische  Format  nicht  dem  Standardformat  entspricht.  Auf  dem 
Atari  ST  mufiten  die  Piktogramme  nicht  umgewandelt  werden,  aber  es  ist  auch  nicht 
falsch,  es  zu  tun. 


— Dialog-Funktionen 

BOOLEAN  background  (OBJECT  *tree,  WORD  obj,  BOOLEAN  get, 

MFDB  ^screen,  MFDB  ^buffer) ; 

Der  Hintergrund  einer  Dialogbox  oder  eines  Mentis  kann  gerettet  oder  wieder  restauriert 
werden.  Der  dafiir  zu  verwendende  Arbeitsspeicher  wird  automatisch  vom  System  ange- 
fordert.  Die  Beschreibungen  (MFDB’s)  fur  Bildschirm  und  Puffer  werden  automatisch 
eingetragen,  lediglich  der  Speicherplatz  dafiir  muB  vom  Aufrufer  in  Form  zweier 
MFDB’s  zur  Verfugung  gestellt  werden. 

background:  TRUE,  wenn  der  Speicherplatz  ausgereicht  hat,  um  den  Hintergrund  zu 
retten,  FALSE  sonst 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objekts 

get  : TRUE,  wenn  der  Hintergrund  geholt  werden  soli,  FALSE,  wenn  er  restau- 

riert werden  soli 

screen  : Zeiger  auf  die  Beschreibung  des  Bildschirms 

buffer  : Zeiger  auf  die  Beschreibung  des  Puffers 
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Bei  alien  Dialogboxen,  Menus  und  Pop-Up-Meniis  werden  alle  Attribute  beriicksichtigt. 
Das  bedeutet,  daB  auch  der  Hintergrund  von  eventuell  vorhandenen,  nach  auBen  gehen- 
den  Randern  gerettet  wird.  Das  gleiche  gilt  fur  eine  eventuelle  Schattierung  der  Objekte 
und  fur  den  Status  OUTLINED.  Natiirlich  darf  auch  eine  beliebige  Kombination  davon 
auftreten.  Die  zu  rettende  Box  wird  auf  eine  Wortgrenze  gebracht,  urn  eine  schnellere 
Arbeitsweise  zu  garantieren. 

Hat  der  Rechner  nicht  mehr  geniigend  Speicherplatz,  urn  den  Hintergrund  abzulegen,  so 
wird  beim  Restaurieren  wenigstens  ein  „form_dial“  mit  FMD_FINISH  aufgerufen, 
damit  der  Screen-Manager  der  Applikation  die  Nachricht  sendet,  Teile  des  Bildschirms 
neu  aufzubauen.  In  diesem  Fall  wird  das  Funktionsergebnis  auch  FALSE  sein. 

BOOLEAN  open_dlal  (OBJECT  *tree,  BOOLEAN  grow,  RECT  *size, 

MFDB  xscreen,  MFDB  ^buffer) ; 

Die  Funktion  bietet  die  Einleitung  zum  Offnen  und  Behandeln  einer  Dialogbox.  Optional 
kann  ein  sich  ausdehnendes  Rechteck  gezeichnet  werden  und  bestimmt  werden,  ob  der 
Hintergrund  gerettet  werden  soil.  Die  Beschreibungen  (MFDB’s)  fiir  Bildschirm  und  Puf- 
fer werden  automatisch  eingetragen,  lediglich  der  Speicherplatz  dafiir  muB  vom  Aufrufer 
in  Form  zweier  MFDB’s  zur  Verfugung  gestellt  werden. 


open_dial: 

tree  : 

grow  : 

size  : 

screen  : 

buffer  : 


TRUE,  wenn  der  Hintergrund  gerettet  werden  sollte  und  auch  konnte, 
FALSE  sonst 

Zeiger  auf  einen  Objektbaum 

TRUE,  wenn  ein  sich  ausdehnendes  Rechteck  gezeichnet  werden  soil,  FAL- 
SE sonst 

Zeiger  auf  die  Beschreibung  des  sich  ausdehnenden  Ausgangsrechtecks  oder 
NULL,  wenn  sich  das  Rechteck  von  der  Bildschirmmitte  ausdehnen  soli 
Zeiger  auf  die  Beschreibung  des  Bildschirms  oder  NULL,  wenn  der  Hinter- 
grund nicht  gerettet  werden  soil 

Zeiger  auf  die  Beschreibung  des  Puffers  oder  NULL,  wenn  der  Hintergrund 
nicht  gerettet  werden  soil 


Beim  Abarbeiten  eines  Dialogs  sollte  die  Maus  ein  Pfeil  sein.  Dieser  wird  hier  gesetzt. 
Nach  Beenden  des  Dialogs  iiber  „close_dial“  wird  wieder  die  vorherige  Form  ange- 
nommen. 


Das  sich  ausdehnende  Rechteck  wird  nur  gezeichnet,  wenn  zusatzlich  zum  angegebenen 
Parameter  die  globale  Variable  „grow_shrink“  TRUE  ist. 

Fiir  X/GEM  tritt  das  Retten  des  Bildschirmhintergrundes  unabhangig  von  den  Parametem 
nicht  in  Kraft.  Der  Grund  liegt  darin  zu  suchen,  daB  jeder  ProzeB  seinen  eigenen  abge- 
schlossenen  Desktop  hat.  Dieser  hat  nur  die  GroBe  der  Vereinigung  aller  in  diesem  Pro- 
zeB dargestellten  und  offenen  Fenster.  Wiirde  statt  eines  Aufrufs  von  „form_dial“  mit 
FMD_START  der  Hintergrund  gerettet  werden,  so  kann  es  passieren,  daB  dieser  nicht 
vollsttodig  auf  dem  Bildschirm  erscheint,  da  alle  aus  dem  Desktop  herausragenden  Teile 
geclippt  werden. 
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BOOLEAN  close_dial  (OBJECT  *tree,  BOOLEAN  shrink,  RECT  *slze, 
MFDB  ^screen,  MFDB  *buf fer) ; 


Die  Funktion  bietet  das  Beenden  der  Behandlung  eines  Dialoges.  Optional  kann  ein  sich 
zusammenziehendes  Rechteck  gezeichnet  werden  und  bestimmt  werden,  ob  der  Bild- 
schirm  aus  dem  geretteten  Hintergrund  restauriert  werden  soil.  Die  Beschreibungen 
(MFDB’s)  fur  Bildschirm  und  Puffer  werden  automatisch  eingetragen,  lediglich  der  Spei- 
cherplatz  dafiir  muB  vom  Aufrufer  in  Form  zweier  MFDB’s  zur  Verftigung  gestellt 
werden. 


close_dial : 

tree  : 

shrink 

size  : 

screen  : 

buffer  : 


TRUE,  wenn  der  Hintergrund  gerettet  werden  sollte  und  auch  konnte, 
FALSE  sonst 

Zeiger  auf  einen  Objektbaum 

TRUE,  wenn  ein  sich  zusammenziehendes  Rechteck  gezeichnet  werden  soil, 
FALSE  sonst 

Zeiger  auf  die  Beschreibung  des  sich  zusammenziehenden  Endrechtecks 
Oder  NULL,  wenn  sich  das  Rechteck  in  die  Bildschirmmitte  zusammen- 
ziehen  soli 

Zeiger  auf  die  Beschreibung  des  Bildschirms  oder  NULL,  wenn  der  Hinter- 
grund nicht  gerettet  werden  sollte 

Zeiger  auf  die  Beschreibung  des  Puffers  oder  NULL,  wenn  der  Hintergrund 
nicht  gerettet  werden  sollte 


Das  sich  zusammenziehende  Rechteck  wird  nur  gezeichnet,  wenn  zusatzlich  zum  angege- 
benen  Parameter  die  globale  Variable  „grow_shrink“  TRUE  ist. 

1st  nach  dem  Aufruf  von  „close_dial“  der  Funktionswert  FALSE,  so  muB  genau  dann 
der  Hintergrund  selbst  restauriert  werden,  wenn  dies  durch  die  Meldungen  des  Screen- 
Managers  nicht  geschehen  kann.  Wird  beispielsweise  nach  dem  Offnen  einer  Dialogbox 
durch  Anwahlen  eines  Knopfes  eine  weitere  Dialogbox  gedffnet  (Unterdialog)  und  der 
Hintergrund  konnte  nicht  gerettet  werden,  so  muB  nach  dem  Verlassen  des  zweiten  Dia- 
logs die  erste  Dialogbox  wieder  gezeichnet  werden.  Ein  Beispiel  ist  im  Modul  MENU 
zu  finden. 


WORD  hndl_dial  (OBJECT  *tree,  WORD  def,  BOOLEAN  grow_shrink, 
BOOLEAN  save_back,  RECT  *size,  BOOLEAN  *ok) ; 


Damit  kann  ein  kompletter  Dialog  abgearbeitet  werden,  wenn  er  keine  Unterdialoge 
(s.o.)  enthalt.  Er  bietet  im  Prinzip  die  Zusammenfassung  von  „open_dial“,  „form_do“ 
und  „close_dial“.  Als  Funktionswert  wird  die  Objektnuramer  des  Knopfes  zuriickge- 
geben,  mit  dem  der  Dialog  beendet  wurde. 


hndl_dial  ; 
tree  : 

def  : 

grow_shrink: 


Die  Objektnummer  des  Knopfes,  mit  dem  der  Dialog  verlassen  wurde 
Zeiger  auf  einen  Objektbaum 

Default-Edit-Objekt,  auf  dem  sich  der  Cursor  befinden  soli 
TRUE,  wenn  ein  sich  ausdehnendes  und  zusammenziehendes  Rechteck 
gezeichnet  werden  soli,  FALSE  sonst 


414 


6 Sin  universelles  Modulkonzept  in  C 


save_back 

size 


ok 


TRUE,  wenn  der  Hintergrund  gerettet  werden  soil,  FALSE  sonst 
Beschreibung  des  Ausgangs-  bzw.  Endrechtecks  fiir  das  Ausdehnen  bzw. 
Schrumpfen  oder  NULL,  wenn  der  Ausgangs-  bzw.  Endpunkt  die  Bild- 
schirmmitte  ist 

Zeiger  auf  eine  Variable,  die  TRUE  liefert,  wenn  der  Hintergrund  geret- 
tet werden  sollte  und  auch  konnte,  FALSE  sonst 


VOID  blink  (OBJECT  *tree,  WORD  obj,  WORD  blinkrate); 

Ein  Objekt  eines  Objektbaumes  wird  zum  Blinken  veranlaBt,  Dies  kann  z.B.  bei  Pop-Up- 
Meniis  oder  Meniizeilen  im  Fenster  benutzt  werden,  um  ein  Macintosh-ahnliches  Gefuhl 
zu  erzeugen. 

tree  : Zeiger  auf  einen  Objektbauni 

obj  : Index  des  Objekts 

blinkrate  : Anzahl  der  Blinkwiederholungen 


WORD  popup_menu  (OBJECT  *tree,  WORD  obj,  WORD  x,  WORD  y, 

WORD  center^obj , BOOLEAN  relative,  WORD  bmsk) ; 


Hiermit  wird  die  Verwaltung  eines  kompletten  Pop-Up-Meniis  ubernommen.  Es  gibt 
mehrere  Moglichkeiten,  die  Abarbeitung  zu  beeinflussen.  Zunachst  muB  ein  Objektbaum 
und  ein  Startobjekt  angegeben  werden.  AuBerdem  kbnnen  die  X-  und  Y-Koordinaten  an- 
gegeben  werden,  wo  das  Pop-Up-Menii  genau  erscheinen  soli.  Es  ist  aber  auch  mbglich, 
das  Pop-Up-Menu  relativ  zur  Mauspostion  anzeigen  zu  lassen,  was  ja  eigentlich  der  Sinn 
eines  Pop-Up-Meniis  ist  (kurze  Mauswege).  SchlieBlich  kann  man  noch  wahlen,  ob  ein 
Objekt  des  Pop-Up-Meniis  sich  mit  seinem  Zentrum  genau  an  der  Mausposition  befmden 
soil.  Fiir  das  Verlassen  des  Pop-Up-Meniis  kann  der  Mausknopf  angegeben  werden. 


popup_menu: 
tree  : 

obj  : 

X 

y : 

center_obj 
relative  : 

bmsk 


Index  des  Objekts,  mit  dem  das  Pop-Up-Menii  beendet  wurde 
Zeiger  auf  einen  Objektbaum 
Index  des  Objekts  (Pop-Up-Meniis) 

X-Offset  des  Pop-Up-Meniis  (absolut  oder  relativ) 

Y-Offset  des  Pop-Up-Meniis  (absolut  oder  relativ) 

Objekt,  in  dessen  Zentrum  die  Maus  erscheint  oder  NIL,  wenn  dieser 
Umstand  nicht  gewiinscht  wird 

TRUE,  wenn  sich  das  Pop-Up-Menii  relativ  zur  Maus  befmden  soil, 
FALSE  sonst. 

Maske  fiir  den  Mausknopf,  der  das  Pop-Up-Menii  beenden  soil.  Das  nie- 
derwertigste  Bit  gibt  den  am  weitesten  links  stehenden  Mausknopf  an, 
usw. 


Es  bietet  sich  an,  mehrere  Pop-Up-Menus  in  einem  Objektbaum  zusammenzufassen. 
„obj“  ist  dann  das  Vaterobjekt  des  jeweiligen  Pop-Up-Meniis  (siehe  auch  SCRAP. RSC). 
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Es  werden  nur  jeweils  die  Eintrage  eines  Pop-Up-Mentis  invertiert,  die  den  Status 
SELECTABLE  haben.  Sie  miissen  selbstverstandlich  auch  nicht  DISABLED  sein.  Da- 
durch  ist  es  mdglich,  weitere  Objekte  wie  Uberschriften  und  erklarenden  Text  in  ein  Pop- 
Up-Menii  hineinzubringen.  Diese  kbnnen  dann  nicht  angewahlt  werden. 

Ein  Pop-Up-Menii  wird  immer  auf  dem  Bildschirm  dargestellt.  Sollte  es  an  irgendeinem 
Rand  aus  diesem  Bereich  herausragen,  so  werden  die  Koordinaten  entsprechend  kor- 
rigiert. 

Ein  Pop-Up-Menii  kann  auf  zwei  Arten  beendet  werden:  entweder  dutch  Loslassen  des 
in  „bmsk“  angegebenen  Mausknopfes  oder  dutch  dessen  Driicken  (siehe  auch  Kapitel  5). 
Das  hangt  davon  ab,  wie  man  das  Pop-Up-Menii  aufgerufen  hat.  Wurde  der  Mausknopf 
gedriickt  und  nicht  losgelassen,  so  kann  man  das  Pop-Up-Menii  dutch  Loslassen  des 
Mausknopfes  beenden  (Macintosh-like).  Wurde  der  Mausknopf  gedruckt  und  sofort  wie- 
der  losgelassen,  so  muB  man  auf  das  entsprechende  Objekt  noch  einmal  klicken 
(GEM-like). 

Beim  Verlassen  des  Pop-Up-Meniis  blinkt  das  zuletzt  angewahlte  Objekt,  Je  nachdem, 
wie  die  globale  Variable  „blinkrate“  eingestellt  wurde. 

BOOLEAN  is_menu_key  (OBJECT  *menu,  MKINFO  *mk, 

WORD  *title,  WORD  *item)j 


Der  Titel  und  der  Meniieintrag  eines  zu  einer  Taste  gehdrigen  Menus  kann  bestimmt  wer- 
den. Die  Tastenkiirzel  miissen  sich  am  rechten  Ende  des  Meniieintrags  befinden  (siehe 
auch  Abb.  5.7).  Die  Taste  und  der  Status  der  Shift-,  Control-  und  Alternate-Tasten  wer- 
den in  einer  Struktur  MKINFO  iibergeben. 


is_menu_key : 
menu 

mk  : 

title  : 

item  : 


TRUE,  wenn  die  Taste  auf  ein  Menu  zutrifft,  FALSE  sonst 
Zeiger  auf  einen  Meniibaum 

Zeiger  auf  eine  Struktur,  die  die  aktuell  betatigte  Taste  beschreibt 
Zeiger  auf  den  Index  des  Titels,  falls  „is_menu_key“  TRUE  ist 
Zeiger  auf  den  Index  des  Meniieintrags,  falls  „is_menu_key“  TRUE 
ist 


Falls  kein  Menii  gefunden  wurde,  ist  „title“  und  „item“  jeweils  NIL.  Es  werden  nur  Ein- 
trage der  Meniizeile  untersucht,  die  den  Typ  G_STRING  haben,  also  keine  Bit-Images 
etc.  Zum  Erkennen  der  Tasten  dient  eine  Tabelle,  welche  in  GLOBAL. C definiert  ist. 
Sie  enthalt  alle  Codes  fiir  Control-  und  Alternate-Kombinationen  sowie  Funktions- 
tastencodes. 


Die  Meniieintrage  konnen  auch  nach  Start  des  Programms  geandert  werden.  Solange  sich 
die  Kiirzel  am  Ende  eines  Meniieintrags  befinden,  werden  diese  erkannt.  Als  Standard- 
symbole  fiir  die  Kiirzel  werden  die  aus  Abbildung  5.7  gezeigten  Symbole  benutzt 
(CTRL^CHAR,  ALT_CHAR,  SHIFT_CHAR,  FUNC_CHAR  in  GLOBAL.C). 
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— Rechteckfunktionen 

Die  Rechteckfunktionen  gehen  iiber  das  hinaus,  was  in  einigen  Compilerbibliotheken  an- 
geboten  wird.  Das  Problem  ist,  dal5  wichtige  Funktionen  wie  z.B.  „rc_intersect“  nicht 
in jeder  Bibliothek  vertreten  sind,  Somit  haben  wjr  sie  implementiert  und  sind  damit  unab- 
hragig  von  den  Compilerbibliotheken. 


BOOLEAN  rc_equal  (CONST  RECT  *pl,  CONST  RECT  *p2); 

Zwei  Rechtecke  konnen  auf  Gleichheit  getestet  werden. 

rc_equal:  TRUE,  wenn  die  Rechtecke  gleich  sind,  FALSE  sonst 
pi  : Zeiger  auf  Rechteck  1 

p2  : Zeiger  auf  Rechteck  2 


VOID  rc_copy  (CONST  RECT  *ps,  RECT  *pd); 

Die  Beschreibung  eines  Rechtecks  wird  in  ein  anderes  kopiert. 

ps;  Zeiger  auf  das  Quellrechteck 
pd:  Zeiger  auf  das  Zielrechteck 


VOID  rc_union  (CONST  RECT  *pl,  RECT  *p2); 

Zwei  Rechtecke  werden  vereinigt.  Das  Vereinigungsrechteck  wird  im  zweiten  Parameter 
(p2)  abgelegt. 

pi:  Zeiger  auf  das  erste  Rechteck 

p2:  Zeiger  auf  das  zweite  Rechteck  (Vereinigungsrechteck) 

Ist  die  Breite  oder  Hohe  des  zweiten  Rechtecks  null,  so  ist  das  Ergebnis  die  Beschreibung 
des  ersten  Rechtecks. 


BOOLEAN  rc_intersect  (CONST  RECT  *pl,  RECT  *p2); 

Zwei  Rechtecke  werden  geschnitten.  Das  Schnittrechteck  wird  im  zweiten  Parameter  (p2) 
abgelegt. 

rc_intersect:  TRUE,  wenn  das  Schnittrechteck  nicht  leer  ist,  FALSE  sonst 

pi  ; Zeiger  auf  das  erste  Rechteck 

p2  : Zeiger  auf  das  zweite  Rechteck  (Schnittrechteck) 
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BOOLEAN  inside  (WORD  x,  WORD  y,  CONST  RECT  *r); 

Testet,  ob  ein  Punkt  in  einem  Rechteck  liegt. 

inside:  TRUE,  falls  der  Punkt  innerhalb  des  Rechtecks  liegt,  FALSE  sonst 
X : X-Koordinate  des  Punkts 

y : Y-Koordinate  des  Punkts 

r : Zeiger  auf  das  Rechteck,  in  welchem  der  Punkt  liegen  soil 


VOID  rect2array  (CONST  RECT  *rect,  WORD  *array); 

Wandelt  eine  Rechteckbeschreibung  in  eine  Feldbeschreibung  urn.  Die  Rechteckbeschrei- 
bung  besteht  aus  X-  und  Y-Koordinate  sowie  Breite  und  Hohe.  Die  Feldbeschreibung  be- 
steht  aus  den  zwei  diagonal  gegeniiberliegenden  Eckpunkten  des  Rechtecks.  Fiir  Funktio- 
nen  des  AES  benotigt  man  meist  eine  Rechteckbeschreibung,  fur  solche  des  VDI  meist 
eine  Eckpunktbeschreibung. 

rect  : Zeiger  auf  das  Rechteck 
array  : Zeiger  auf  die  Feldbeschreibung 


VOID  array2rect  (CONST  WORD  *array,  RECT  *rect); 

Gegenstiick  zu  „rect2array“. 

array  : Zeiger  auf  die  Feldbeschreibung 
rect  : Zeiger  auf  das  Rechteck 


VOID  xywh2array  (WORD  x,  WORD  y,  WORD  w,  WORD  h,  WORD  *array); 

Wie  „rect2array“,  nur  dafi  statt  der  Rechteckbeschreibung  in  einer  Struktur  vier  einzelne 
Werte  ubergeben  werden. 

X : X-Koordinate  des  Rechtecks 

y : Y-Koordinate  des  Rechtecks 

w : Breite  des  Rechtecks 

h : Hohe  des  Rechtecks 

array  : Zeiger  auf  die  Feldbeschreibung 


VOID  array2xywh  (CONST  WORD  it  array, 

WORD  itx,  WORD  *y,  WORD  *w,  WORD  *h); 
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Gegenstiick  zu  „xywh2array“. 

array  : Zeiger  auf  die  Feldbeschreibung 

X : Zeiger  auf  die  X-Koordinate  des  Rechtecks 

y : Zeiger  auf  die  Y-Koordinate  des  Rechtecks 

w : Zeiger  auf  die  Breite  des  Rechtecks 

h : Zeiger  auf  die  Hohe  des  Rechtecks 


VOID  xywh2rect  (WORD  x,  WORD  y,  WORD  w,  WORD  h,  RECT  *rect); 

Eine  Rechteckbeschreibung  wird  mit  den  vier  Werten  X-,  Y-Koodinate,  Breite  und  Hohe 
gefiillt. 

X : X-Koordinate  des  Rechtecks 

y : Y-Koordinate  des  Rechtecks 

w : Breite  des  Rechtecks 

h : Hohe  des  Rechtecks 

rect  : Zeiger  auf  das  Rechteck 


VOID  rect2xywh  (CONST  RECT  *rect, 

WORD  *x,  WORD  *y,  WORD  *w,  WORD  *h); 

Gegenstiick  zu  „xywh2rect“. 

rect  : Zeiger  auf  das  Rechteck 

X : Zeiger  auf  die  X-Koordinate  des  Rechtecks 

y : Zeiger  auf  die  Y-Koordinate  des  Rechtecks 

w : Zeiger  auf  die  Breite  des  Rechtecks 

h : Zeiger  auf  die  Hohe  des  Rechtecks 


VOID  set__clip  (BOOLEAN  flag,  CONST  RECT  *size); 

Das  Clipping-Rechteck  fiir  grafische  Ausgaben  iiber  das  VDI  kann  gesetzt  oder  zuriickge- 
setzt  werden. 

flag;  TRUE,  wenn  das  Clipping  gesetzt,  FALSE  wenn  es  zuruckgesetzt  (deaktiviert) 
werden  soil 

size;  Zeiger  auf  das  Rechteck,  welches  das  Clipping  beschreibt 

Wird  kein  Rechteck  angegeben  (size  = = NULL),  so  wird  der  Desktop  als  Rechteck  an- 
genommen.  Die  zuletzt  gesetzten  Werte  werden  in  der  globalen  Variablen  „clip“  ge- 
sichert. 
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VOID  growbox  (CONST  RECT  *st,  CONST  RECT  *fin); 

Ein  sich  ausdehnendes  Rechteck  kann  gezeichnet  werden.  Falls  die  globale  Variable 
„grow_shrink“  auf  FALSE  steht,  wird  der  Aufruf  ignoriert. 

St  : Startrechteck  (kleines  Rechteck) 
fin  ; Endrechteck  (groBes  Rechteck) 

Fiir  GEM-Versionen,  in  welchen  keine  „graf_growbox“-  bzw.  „graf_shrinkbox“- 
Funktionen  inaplementiert  sind,  werden  diese  mittels  der  „xgrf“-Library  nachgebildet. 


VOID  shrinkbox  (CONST  RECT  *fin,  CONST  RECT  *st); 

Gegenstiick  zu  „growbox“.  Auch  hier  wird  die  globale  Variable  „grow_shrink“  be- 
riicksichtigt. 

fin  : Endrechteck  (kleines  Rechteck) 

St  : Startrechteck  (groBes  Rechteck) 


— Fehlerbehandlung 
VOID  beep  (VOID); 

Gibt  ein  Piepszeichen  aus,  sofern  die  globale  Variable  „ring_belT‘  auf  TRUE  steht. 
Sonst  wird  der  Aufruf  ignoriert.  Fiir  Atari’s  GEM  wird  ein  BIOS- Aufruf  benutzt,  bei  al- 
ien anderen  GEM-Versionen  der  VDI- Aufruf  „v  sound".  Das  Piepszeichen  wird  auch 
ausgegeben,  fails  noch  keine  virtuelle  Workstation  gedffnet  war,  da  das  „phys_handle“ 
benutzt  wird. 


WORD  note  (WORD  button,  WORD  index,  WORD  helpinx,  OBJECT  *helptree); 

Es  kann  eine  Warnmeldung  oder  Notiz  in  Form  einer  Alertbox  auf  dem  Bildschirm  ausge- 
geben werden.  Zusatzlich  wird  noch  die  Mdglichkeit  geboten,  eine  Hilfemeldung  einzu- 
blenden,  falls  der  Benutzer  auf  einen  Knopf  mit  z.B.  der  Aufschrift  „HILFE“  driickt. 

note  : Nummer  des  Knopfes,  mit  dem  die  Alertbox  verlassen  wurde  (normalerweise 
1 bis  3) 

button  : Default-Button  der  Alertbox 

index  : Nummer  der  Alertbox,  meist  ein  Bezeichner  aus  der  Resource-Datei 
helpinx  : Nummer  des  Knopfes,  bei  dessen  Betiitigung  eine  Hilfemeldung  eingeblendet 
werden  soil,  oder  NIL 

helptree  : Baum,  der  die  Hilfemeldung  beherbergt,  oder  NULL 


420 


6 Ein  universelles  Modulkonzept  in  C 


Mochte  man  dem  Benutzer  zu  jeder  Fehler-  und  Warnmeldung  die  Mdglichkeit  geben, 
eine  Hilfemeldung  einzublenden,  so  iibergibt  man  in  „helpinx“  die  Nummer  des  Knopfes, 
der  die  Aufschrift  „HILFE“  tragt.  Bietet  man  keine  Hilfe  an,  so  kann  man  auch  NIL  iiber- 
geben.  Falls  der  Benutzer  auf  „HILFE“  klickt,  so  erscheint  die  unter  „helptree“  angege- 
bene  Dialogbox.  Der  Hintergrund  wird  automatisch  gerettet.  Nach  Abarbeiten  der  Hilfe- 
Dialogbox  wird  die  Warnmeldung  wieder  eingeblendet.  Der  Benutzer  kann  nun  wieder 
„HILFE“  wahlen  oder  auch  „OK“,  „ABBRUCH“  und  Ahnliches. 

Ein  Zeiger  auf  die  Adressen  der  Warn-  oder  Fehlermeldungen,  welche  im  RCS  erstellt 
wurden,  miissen  vorher  in  der  Variablen  „alertmsg“  untergebracht  werden.  Dies  ge- 
schieht  im  Modul  RESOURCE, 


WORD  error  (WORD  button,  WORD  index,  WORD  helpinx,  OBJECT  *helptree); 

Es  kann  eine  Fehlermeldung  ausgegeben  werden.  Der  Ablauf  ist  der  gleiche  wie  bei  „no- 
te“,  nur  da(5  zusatzlich  ein  Piepszeichen  ausgegeben  wird,  falls  die  globale  Variable 
„ring,_beU“  auf  TRUE  gestellt  ist. 

error  : Nummer  des  Knopfes,  mit  dem  die  Alertbox  verlassen  wurde  (normalerweise 
1 bis  3) 

button  : Default-Button  der  Alertbox 

index  : Nummer  der  Alertbox,  meist  ein  Bezeichner  aus  der  Resource-Date i 
helpinx  : Nummer  des  Knopfes,  bei  dessen  Betatigung  eine  Hilfemeldung  eingeblendet 
werden  soli,  oder  NIL 

helptree  : Baum,  der  die  Hilfemeldung  beherbergt,  oder  NULL 


— Speicherfunktionen 

VOID  *mem_„alloc  (LONG  mem); 

Der  damit  allokierte  Speicher  wird  uber  eine  Betriebssystemfunktion  aufgerufen,  nicht 
iiber  eine  Standard-C-Funktion,  da  sich  nicht  bei  jedem  Compiler  mehr  als  64KByte  allo- 
kieren  lassen. 

mem_a!loc:  Zeiger  auf  den  allokierten  Speicherbereich  oder  NULL,  wenn  kein  Spei- 
cher mehr  frei  war. 

mem  : Anzahl  der  zu  allokierenden  Bytes 


BOOLEAN  mem_free  (VOID  *memptr); 

Der  vorher  mit  „mem_alloc“  allokierte  Speicherplatz  kann  hiermit  wieder  freigegeben 
werden. 
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mem  free  : TRUE,  wenn  die  Freigabe  geklappt  hat,  FALSE  sonst 

memptr  : Zeiger  auf  den  vorher  dutch  „mem_alloc“  angeforderten  Speicherplatz 


LONG  mem_avail  (VOID); 

Die  Anzahl  der  noch  freien  Bytes  des  Hauptspeichers  kann  ermittelt  werden. 
mem_avail : Anzahl  der  freien  Bytes  des  Hauptspeichers 


VOID  *mem_set  (VOID  *dest,  WORD  val,  UWORD  len); 

Ein  bestimmter  Bereich  des  Speichers  (maximal  64KByte)  kann  mit  einem  Wert  gefiillt 
werden.  1st  diese  Funktion  in  einer  Compiler-Bibliothek  vorhanden,  so  wird  sie  benutzt, 
ansonsten  hier  implementiert. 

mem  set  : Zeiger  auf  den  Zielspeicherbereich  (dest). 
dest  : Zeiger  auf  den  Speicherbereich,  der  gefiillt  werden  soli 

val  : Wert,  mit  dem  der  Speicherbereich  gefiillt  wird 

len  : Anzahl  der  zu  fiillenden  Bytes 


VOID  *mem  move  (VOID  +dest,  CONST  VOID  *src,  UWORD  len); 

Ein  Speicherbereich  (maxima!  64KByte)  kann  in  einen  anderen  verschoben  werden.  Da- 
bei  werden  Uberlappungen  automatisch  beriicksichtigt.  1st  diese  Funktion  in  einer 
Compiler-Bibliothek  vorhanden,  so  wird  sie  benutzt,  ansonsten  hier  implementiert. 

mem_move:  Zeiger  auf  den  Zielbereich  (dest) 
dest  : Zeiger  auf  den  Zielbereich 

src  : Zeiger  auf  den  Ursprungsbereich 

len  : Anzahl  der  zu  verschiebenden  Bytes 


VOID  *mem_Iset  (VOID  *dest,  WORD  val,  ULONG  len); 

Wie  „mem_set“,  jedoch  konnen  maximal  4GByte  gefiillt  werden. 

mem  set  : Zeiger  auf  den  Zielspeicherbereich  (dest). 
dest  : Zeiger  auf  den  Speicherbereich,  der  gefiillt  werden  soil 

val  : Wert,  mit  dem  der  Speicherbereich  gefullt  wird 

len  : Anzahl  der  zu  fullenden  Bytes 
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VOID  *mem  Imove  (VOID  *dest,  CONST  VOID  *src,  ULONG  len); 


Wie  „mem_move“,  jedoch  konnen  maximal  4GByte  verschoben  werden. 


mem_move: 
dest  : 

src 
len 


Zeiger  auf  den  Zielbereich  (dest) 
Zeiger  auf  den  Zielbereich 
Zeiger  auf  den  Ursprungsbereich 
Anzahl  der  zu  verschiebenden  Bytes 


— Zeichenkettenfunktionen 
BYTE  *str_upper  (BYTE  *s); 

Die  Buchstaben  einer  Zeichenkette  werden  in  Grofibuchstaben  umgewandelt.  Nationale 
Sonderzeichen  werden  nicht  beriicksichtigt.  1st  diese  Funktion  in  einer  Compiler- 
Bibliothek  vorhanden,  so  wird  sie  benutzt,  ansonsten  hier  implementiert. 

str_upper  : Zeiger  auf  die  Zeichenkette  (s) 

s : Zeiger  auf  die  Zeichenkette,  die  konvertiert  werden  soil 

BYTE  *str  lower  (BYTE  *s); 

Die  Buchstaben  einer  Zeichenkette  werden  in  Kleinbuchstaben  umgewandelt.  Nationale 
Sonderzeichen  werden  nicht  beriicksichtigt.  1st  diese  Funktion  in  einer  Compiler- 
Bibliothek  vorhanden,  so  wird  sie  benutzt,  ansonsten  hier  implementiert. 

str_lower  : Zeiger  auf  die  Zeichenkette  (s) 

s : Zeiger  auf  die  Zeichenkette,  die  konvertiert  werden  soil 


— Mengenfunktionen 

Mengen  sind  Datentypen,  die  eine  bestimmte  Anzahl  von  Objekten  aufnehmen  konnen. 
Sie  reprasentieren  genau  das,  was  in  der  Mathematik  auch  als  Menge  bezeichnet  wird 

— nur  mit  einem  endlichen  Vorrat  an  Elementen.  In  Programmiersprachen  wie  Pascal 
Oder  Modula  gibt  es  solche  Mengen,  auch  Sets  genannt. 

1st  die  Anzahl  der  Elemente  einer  Menge  null,  so  spricht  man  auch  von  einer  leeren  Men- 
ge. Auf  Mengen  konnen  verschiedene  Operationen  angewendet  werden.  Intern  werden 
sie  durch  einen  Bitvektor  realisiert.  Dieser  Bitvektor  hat  eine  bestimmte  GroBe.  Jedes  Bit 
entspricht  genau  einem  Element.  In  einem  Langwort  beispielsweise  konnen  genau  32  Ele- 
mente untergebracht  werden.  Wir  werden  groBere  Mengen  benotigen  und  definieren  eine 
Menge  als  eine  Folge  von  32  Langwbrtern,  d.h.  eine  Menge  kann  32x32  = 1024  Elemen- 
te besitzen.  Die  folgenden  Definitionen  (siehe  GLOBAL. H)  spiegeln  diesen  Umstand 
wider: 
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# define  SETSIZE  32 

# define  SETMAX  (SETSIZE  *32-1) 

typedef  ULONG  SET  [SETSIZE]; 

Der  Vorteil  einer  Menge  gegeniiber  herkommlichen  Variablen  besteht  darin,  dafi  sehr 
schnell  getestet  werden  kann,  ob  bestimmte  Elemente  in  dieser  Menge  enthalten  sind.  Au- 
Berdem  kann  ein  Element  nur  einmal  in  einer  Menge  vorkommen.  Eine  Anwendung  fur 
Mengen  sind  Objekte,  die  vom  Benutzer  in  einem  Fenster  angewahlt  werden  konnen.  Je- 
des  Objekt  hat  eine  Nummer  (von  null  aufsteigend).  Maximal  1024  Objekte  (0—  1023) 
konnen  in  einer  solchen  Menge  Platz  finden.  Zu  den  logischen  Operatoren,  die  auf  eine 
Menge  angewendet  werden  konnen,  zahlen  z.B.  Durchschnitt,  Vereinigung  und  Dif- 
ferenz. 

Anwendung  sbeispiele  fiir  Mengen  finden  sich  in  den  Modulen  CLIPBRD  und  DESKTOP 
sowie  MENU. 


VOID  setcpy  (SET  setl,  CONST  SET  set2); 

Eine  Menge  wird  in  eine  andere  kopiert. 

setl:  Zeiger  auf  die  Zielmenge 
set2:  Zeiger  auf  die  Quellmenge 

VOID  setall  (SET  set); 

Alle  Elemente  einer  Menge  werden  gesetzt. 

set:  Zeiger  auf  die  Menge,  in  der  die  Elemente  gesetzt  werden 


VOID  setclr  (SET  set); 

Alle  Elemente  einer  Menge  werden  geloscht. 

set : Zeiger  auf  die  Menge,  in  der  die  Elemente  geloscht  werden 


VOID  setnot  (SET  set); 

Alle  Elemente  einer  Menge  werden  negiert.  Elemente,  die  vorher  nicht  in  der  Menge  wa- 
ren,  befinden  sich  nun  in  der  Menge.  Elemente,  die  vorher  in  der  Menge  waren,  befmden 
sich  nun  nicht  mehr  in  der  Menge. 

set:  Zeiger  auf  die  Menge,  in  der  die  Elemente  negiert  werden 
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VOID  setand  (SET  setl,  CONST  SET  set2); 

Zwei  Mengen  werden  mit  einer  UND-Operation  verkniipft  (Durchschnitt).  Das  Ergebnis 
ist  eine  Menge,  in  der  nur  die  Elemente  vorkommen,  die  in  beiden  Mengen  vorhanden 
waren.  Das  Ergebnis  ( = Zielmenge)  findet  sich  in  der  ersten  Menge. 

setl:  Zeiger  auf  erste  Menge  (=  Zielmenge) 
set2:  Zeiger  auf  zweite  Menge 


VOID  setor  (SET  setl,  CONST  SET  set2); 

Zwei  Mengen  werden  mit  einer  ODER-Operation  verknupft  (Vereinigung).  Das  Ergebnis 
ist  eine  Menge,  in  der  die  Elemente  vorkommen,  die  in  der  einen  oder  der  anderen  Menge 
vorhanden  waren.  Das  Ergebnis  ( = Zielmenge)  findet  sich  in  der  ersten  Menge. 

setl:  Zeiger  auf  erste  Menge  (=  Zielmenge) 
set2:  Zeiger  auf  zweite  Menge 


VOID  setxor  (SET  setl,  CONST  SET  set2); 

Zwei  Mengen  werden  mit  einer  Exklusiv-ODER-Operation  verknupft  (symmetrische  Dif- 
ferenz).  Das  Ergebnis  ist  eine  Menge,  in  der  nur  die  Elemente  vorkommen,  die  nicht  in 
einer  der  beiden  Mengen  vorhanden  waren.  Das  Ergebnis  ( = Zielmenge)  findet  sich  in 
der  ersten  Menge. 

setl:  Zeiger  auf  erste  Menge  (=  Zielmenge) 
set2:  Zeiger  auf  zweite  Menge 


VOID  setincl  (SET  set,  WORD  elt); 

Ein  Element  wird  einer  Menge  hinzugefugt.  Ist  dieses  Element  bereits  darin  enthalten, 
so  passiert  nichts. 

set:  Zeiger  auf  die  Menge,  zu  der  ein  Element  hinzugefugt  wird 
elt : Element,  welches  hinzugefugt  werden  soil 


VOID  setexcl  (SET  set,  WORD  elt); 

Ein  Element  wird  aus  einer  Menge  entfernt.  War  dieses  Element  nicht  in  der  Menge  ent- 
halten, so  passiert  nichts. 


set:  Zeiger  auf  die  Menge,  aus  der  ein  Element  entfernt  wird 
elt : Element,  welches  entfernt  werden  soil 
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BOOLEAN  setin  (CONST  SET  set,  WORD  elt); 

Es  wird  gepriift,  ob  ein  Element  in  einer  Menge  ist  oder  nicht. 

setin:  TRUE,  wenn  das  Element  in  der  Menge  ist,  FALSE  sonst 
set  : Zeiger  auf  die  Menge,  die  gepriift  werden  soli 
elt  : Element,  welches  gepriift  werden  soli 


BOOLEAN  setcmp  (CONST  SET  setl,  CONST  SET  set2); 

Zwei  Mengen  werden  miteinander  verglichen.  Sind  sie  gleich,  so  wird  TRUE  zuriickge- 
geben.  Gibt  man  keine  zweite  Menge  an  (NULL),  so  wird  mit  der  leeren  Menge  ver- 
glichen. 

setcmp:  TRUE,  wenn  beide  Mengen  gleich  sind,  FALSE  sonst 
setl  Zeiger  auf  die  erste  Menge  : 

set2  Zeiger  auf  die  zweite  Menge  Oder  NULL,  wenn  mit  der  leeren  Menge  verT 

glichen  werden  soli 


WORD  setcard  (CONST  SET  set); 

Die  Anzahl  der  Elemente  einer  Menge  wird  berechnet. 
setcard:  Anzahl  der  Elemente  der  Menge 

set  : Zeiger  auf  die  Menge,  deren  Elementanzahl  berechnet  wird 


- Verschiedenes 


VOID  file_split  (BYTE  *fullname,  WORD  *drive,  BYTE  *path, 

BYTE  ^filename,  BYTE  *ext); 

proportionaler  Zeichensatz 

Ein  Dateiname  wird  in  seine  Komponenten  zerlegt.  Existieren  bestimmte  Komponenten 
nicht  (Laufwerk  oder  Pfad),  so  werden  die  aktuellen  Werte  eingesetzt. 


fultname : 
drive 

path 

filename : 
ext  : 


Dateiname,  der  alle  oder  ein  Teil  der  Komponenten  enthalten  kann 
Zeiger  auf  das  Laufwerk,  welches  im  Dateinamen  angegeben  wurde,  oder  auf 
das  aktuelle  Laufwerk,  wenn  keines  angegeben  wurde 
Zeiger  auf  den  Pfad  mit  abschlieBendem  welcher  im  Dateinamen  angege- 
ben wurde,  oder  den  aktuellen  Pfad,  wenn  keiner  angegeben  wurde 
Zeiger  auf  den  Dateinamen 
Zeiger  auf  die  Extension 
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Falls  „drive“  NULL  1st,  wird  kein  Laufwerk  zuriickgegeben.  Falls  „path“  NULL  1st, 
wird  kein  Pfad  zuruckgeliefert.  Falls  „filename“  NULL  ist,  wird  kein  Dateiname  zuruck- 
geliefert.  Falls  „ext“  NULL  ist,  wird  die  Extension  im  Dateinamen  angegeben  (falls  eine 
existiert).  Die  Extension  eines  Dateinamens  erhalt  man  also  z.B.  in  der  Variablen  „ext“ 
durch  einen  Aufruf  von 

file_split  (fullname,  NULL,  NULL,  NULL,  ext), 
wenn  „fullname“  den  gesamten  Namen  angibt. 


BOOLEAN  gel_path  (BYTE  *path,  WORD  drive); 

Der  aktuelle  Pfad  eines  Laufwerks  kann  geholt  werden.  Der  Pfad  ist  immer  vollstandig, 
und  zwar  unabhangig  vom  Betriebssystem,  d.h.  mit  fiihrendem  und  abschlieliendem  „\“ . 

get_path:  TRUE,  wenn  der  Pfad  zum  Laufwerk  existiert,  FALSE  sonst 
path  : Zeiger  auf  den  Pfad 

drive  : Laufwerk,  von  dem  der  Pfad  bestimmt  werden  soli 

0 = aktuelles  Laufwerk 

1 = Laufwerk  A 

2 = Laufwerk  B,  usw. 


BOOLEAN  set_path  (CONST  BYTE  *path); 

Der  aktuelle  Pfad  eines  Laufwerks  kann  gesetzt  werden.  Der  Pfad  kann  unabhangig  vom 
Betriebssystem  mit  oder  ohne  abschliefiendem  „\“  sein. 

set_path : TRUE,  wenn  der  Pfad  gesetzt  werden  konnte,  FALSE  sonst 

path  : Zeiger  auf  den  Pfad,  der  gesetzt  werden  soil  (mit  oder  ohne  Laufwerksangabe) 


BOOLEAN  file_exist  (CONST  BYTE  *ftlename); 

Es  kann  gepriift  werden,  ob  eine  Datei  existiert  oder  nicht,  ohne  auf  diese  zuzugreifen. 
Dies  ist  besonders  im  Multiuser-Betrieb  gunstig  (Shared-Open  nicht  notig). 

file_exist:  TRUE,  wenn  die  Datei  existiert,  FALSE  sonst 
filename  : Zeiger  auf  den  Dateinamen 


BOOLEAN  path_exist  (CONST  BYTE  ^pathname); 

Es  kann  gepriift  werden,  ob  ein  Pfad  existiert  oder  nicht.  Dabei  ist  es  irrelevant,  ob  der 
abschlieliende  „\“  angegeben  wird  oder  nicht. 
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path_exist:  TRUE,  wenn  der  Pfad  existiert,  FALSE  sonst 
pathname  : Zeiger  auf  den  Pfadnamen 


BOOLEAN  select_file  (CONST  BYTE  *name,  CONST  BYTE  *suffix, 

BYTE  *filename); 

Mit  Hilfe  der  Dateiauswahl-Box  von  GEM  kann  eine  Datei  gewahlt  werden.  Dabei  kann 
ein  Standard-Namen  (z.B.  NAMENLOS.DOC)  sowie  ein  Suffix  angegeben  werden  (z.B. 
„*.DOC“). 

select_file:  TRUE,  wenn  eine  Datei  ausgewahlt  und  OK  gewahlt  wurde,  FALSE  sonst 
name  : Zeiger  auf  einen  Dateinamen,  der  als  Default-Namen  angeboten  wird 

suffix  ; Zeiger  auf  ein  Suffix,  welches  als  Default-Suffix  angeboten  wird 

filename  ; Resultierender  kompletter  Dateiname 

Bei  dieser  Funktion  werden  auch  die  globalen  Variablen  „fs_path“,  „fs_sel“  und 
„fs_button“  gesetzt.  1st  der  Parameter  „suffix“  nicht  leer,  so  wird  er  in  die 
Dateiauswahl-Box  gesetzt,  ansonsten  wird  das  zuletzt  eingestellte  Suffix  benutzt. 

1st  der  Parameter  „name“  nicht  leer,  so  wird  er  in  die  Dateiauswahl-Box  gesetzt,  anson- 
sten wird  der  zuletzt  gewahlte  Name  nicht  verandert. 

Wird  zwar  der  OK-Knopf  gewahlt,  aber  keine  Datei  spezifiziert,  so  hat  dies  dieselbe  Wir- 
kung  wie  das  Wahlen  des  Abbruch-Knopfes. 


BOOLEAN  init_global  (INT  argc,  BYTE  *argv  [],  BYTE  *acc_menu, 

WORD  class); 

Das  Modul  GLOBAL  wird  initialisiert.  Dieser  Aufruf  muB  erfolgen,  bevor  andere  Funk- 
tionen  des  Moduls  benutzt  werden. 

init_global:  TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 
argc  : „argc“  aus  der  Parameterliste  von  „main“ 

argv  : „argv“  aus  der  Parameterliste  von  „main“ 

acc_menu  : Zeiger  auf  die  Zeichenkette,  die  in  das  Accessory-Menu  geschrieben  wird 

class  ; Klasse  des  Desktops,  entweder  DESK  oder  DESKWINDOW  (vor  allem 

X/GEM) 

Im  einzelnen  laufen  folgende  Schritte  ab: 

a)  Die  Applikation  wird  beim  GEM  angemeldet  (appLinit).  Dies  geschieht  unabhangig 
und  korrekt  fiir  jede  GEM-Version  und  jeden  Compiler. 
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b)  Die  globalen  Variablen  werden  vorbesetzt.  Dazu  gehort  das  Ermitteln  des 
„phys_handle“,  der  Zeichenbreiten  und  -hohen  und  der  Desktop-GroBe. 

c)  Das  aktuelle  Laufwerk  und  der  aktuelle  Zugriffspfad  werden  geholt. 

d)  Die  Parameter  aus  der  Kommandozeile  werden  ermittelt.  1st  „argc“  groBer  als  eins, 
so  werden  „argc“  und  „argv“  benutzt,  andernfalls  „shel_read“.  Falls  mehrere  Para- 
meter existieren,  werden  diese  hintereinander  gehangt. 

e)  Aus  der  Kommandozeile  wird  der  Name  des  aufrufenden  Programms  extrahiert, 
sofern  dieser  existiert. 

f)  Falls  die  Kommandozeile  Kommata  enthiilt,  werden  diese  durch  Leerzeichen  ersetzt 
(siehe  auch  Kapitel  5.5). 

g)  Der  Programmname  (ohne  Pfad)  und  der  Pfadname  der  Applikation  werden  unabhan 
gig  von  der  GEM-Version  ermittelt. 

h)  Es  wird  untersucht,  ob  es  sich  beim  laufenden  Programm  um  eine  Applikation  oder 
ein  Accessory  handelt.  Dies  geschieht  unabhangig  vom  Betriebssystem,  von  der 
GEM-Version  oder  dem  benutzten  Compiler  und  funktioniert  auch  fur  Accessories, 
welche  ein  „rsrc__load“  verwenden. 

i)  Falls  es  sich  um  ein  Accessory  handelt,  wird  das  Accessory-Menu  gesetzt.  AuBerdem 
wird  der  Desktop,  falls  vorhanden,  in  ein  echtes  Fenster  gelegt.  Handelt  es  sich  nicht 
um  ein  Accessory,  wird  lediglich  die  Klasse  des  Desktops  aus  dem  Parameter  „class“ 
iibernommen. 

j)  Das  Scrapdirectory  wird  geholt.  1st  es  noch  nicht  gesetzt,  wird  es  nach  dem  in  Kapitel 
5 vorgestellten  Algorithmus  ermittelt  und  gesetzt. 


BOOLEAN  term  global  (VOID); 

Das  Modul  GLOBAL  wird  terminiert.  Dieser  Aufruf  sollte  der  letzte  eines  Programms 
sein.  Die  virtuelle  Workstation  wird  geschlossen,  falls  sie  geoffnet  war,  und  die  Applika- 
tion beim  GEM  abgemeldet. 

term_global:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.3  Modul  WINDOWS 

Das  Modul  WINDOWS  bietet  einen  flexiblen  Window-Manager,  der  oberhalb  des  GEM- 
Window-Managers  anzusetzen  ist.  Es  vereinfacht  die  Fensterhandhabung  durch  Zusam- 
menfassen  von  GEM-typischen  Sequenzen,  ohne  dabei  an  Flexibilitat  einzubuBen.  Ein 
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Fenster  kann  man  sich  als  Objekt  vorstellen,  welches  auf  verschiedene  Nachrichten  rea- 
gieren  muB.  Dies  konnen  Tastenbetatigungen,  Mausklicks  oder  auch  Zeitereignisse  usw. 
sein.  Der  Window-Manager  leitet  die  entsprechenden  Meldungen  des  OEMs  an  die  Fen- 
ster, fiir  welche  die  Meldungen  bestimmt  sind. 

Urn  besser  mit  den  Fenstern  zu  arbeiten,  legt  sich  der  Window-Manager  eine  Liste  aller 
in  diesem  ProzeB  kreierten  bzw.  gedffneten  Fenster  an.  So  weiB  er  immer,  welches  Fen- 
ster oben  liegt  bzw.  in  welcher  Reihenfolge  die  Fenster  auf  dem  Bildschirm  erscheinen. 

Das  Konzept  des  Window-Managers  wurde  bereits  in  Kapitel  6.3  recht  ausfiihrlich  er- 
klart.  An  dieser  Stelle  folgen  nun  alle  Funktionsaufrufe  an  den  Window-Manager. 

a)  Globale  Variablen 

GLOBAL  WINDOWP  seLwindow; 

„sel_window“  ist  ein  Zeiger  auf  die  Beschreibung  eines  Fensters.  Es  handelt  sich  um 
das  Fenster,  das  zuletzt  angeklickt  wurde  (selektiertes  Fenster).  Die  Variable  nimmt  den 
Wert  NULL  an,  wenn  kein  Fenster  angeklickt  wurde  oder  das  Fenster  nicht  anklickbar 
ist,  d.h.  in  diesem  Fenster  kein  Objekt  selektiert  werden  kann.  Mit  Hilfe  dieser  Variablen 
kann  das  Modul  MENU  entscheiden,  auf  welches  Objekt  z.B.  die  Aktion  „Hilfe“  Oder 
„Info“  angewandt  werden  soil. 

Es  kann  immer  nur  maximal  ein  Fenster  selektiert  sein.  Ahnlich  wie  im  Desktop  soli  beim 
Anklicken  eines  Fensters,  in  welchem  keine  Objekte  selektiert  sind,  automatisch  das  zu- 
letzt selektierte  Fenster  deselektiert  werden. 


GLOBAL  SET  sel_objs; 

Es  handelt  sich  um  die  Menge  von  (maximal  1024)  Objekten,  die  im  Fenster 
„sel_window“  angeklickt  sind.  Ist  die  Menge  nicht  so  einfach  abzahlbar,  so  muB  diese 
Variable  nicht  unbedingt  benutzt  werden.  Fiir  ein  Fenster  kann  auch  ein  anderer  Algorith- 
mus  benutzt  werden,  der  sich  angewahlte  Objekte  merkt  (z.B.  die  Verwaltung  einer  linea- 
ren  Liste  o.a.). 


b)  Globale  Funktionen 

WINDOWP  search_window  (WORD  class,  WORD  mode,  WORD  icon); 

Es  kann  nach  dem  obersten  Fenster  gesucht  werden,  welches  einer  bestimmten  Klasse 
angehort,  einen  bestimmten  Modus  hat  und  zu  einem  bestimmten  Piktogramm  gehort. 

search^ window:  Zeiger  auf  das  gefundene  Fenster  oder  NULL,  wenn  kein  Fenster  der 
Spezifikation  geniigt 
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class  ; Klasse  des  Fensters  oder  NIL,  wenn  die  Klasse  keine  Rolle  spielt 
mode  : Modus,  in  dem  sich  das  Fenster  befmdet: 

SRCH_CLOSED : Es  wird  ein  geschlossenes  Fenster  gesucht 
SRCH_OPENED:  Es  wird  ein  geoffnetes  Fenster  gesucht 
SRCH_ANY  : Beide  Moglichkeiten 

icon  : Piktogramm,  das  zu  dem  eben  genannten  Fenster  gehort,  oder  NIL,  wenn  es  an 
kein  Piktogramm  gekoppelt  ist 

Ein  Beispiel  wird  unter  anderem  im  Modul  CLIPBRD  gegeben.  Beim  Offnen  des  Klemm- 
brettes  wird  zunachst  nach  einem  bereits  offenen  Klemmbrettfenster  gesucht 
(CLASS_CLIPBRD,  SRCH_OPENED,  icon).  Ist  es  vorhanden,  so  wird  es  lediglich 
nach  oben  gebracht. 

Im  anderen  Fall  wird  nach  einem  geschlossenen  Klemmbrettfenster  gesucht 
(CLASS_CLIPBRD,  SRCH_CLOSED,  icon).  Ist  keines  vorhanden,  so  wird  eines 
kreiert.  Dann  wird  das  kreierte  oder  das  bereits  gefundene  geschlossene  Fenster  gedffnet. 


WINDOW?  find  window  (WORD  wh); 

Es  kann  nach  einem  Fenster  gesucht  werden,  von  dem  das  GEM -Window-Handle  bekannt 
ist. 

find_window:  Zeiger  auf  das  gefundene  Fenster  oder  NULL,  wenn  kein  Fenster  mit 
einem  bestimmten  Handle  existiert 
wh  : GEM- Window-Handle  des  zu  suchenden  Fensters 

Die  Funktion  kann  uberall  dort  eingesetzt  werden,  wo  man  eine  Fensterbeschreibung  be- 
ndtigt,  aber  von  GEM  nur  ein  Handle  bekommt.  Dies  ist  zum  Beispiel  nach  jedem  GEM- 
Fenster-Ereignis  der  Fall,  aber  auch  beim  Klick-Ereignis,  wo  man  zunachst  das  Handle 
des  angeklickten  Fensters  bestimmt,  dann  dessen  Beschreibung  (siehe  Modul  EVENT). 


WINDOW?  fmd_top  (VOID); 

Die  Funktion  liefert  einen  Zeiger  auf  die  Fensterbeschreibung  des  obersten  Fensters. 

fmd_top:  Zeiger  auf  das  oberste  Fenster  oder  NULL,  wenn  kein  Fenster  offen  ist 

Im  Modul  MENU  wird  die  Funktion  eingesetzt,  um  das  oberste  Fenster  festzustellen. 
Abhangig  davon  konnen  dann  bestimmte  Meniipunkte  abgeschaltet  werden  (z.B.  CUT/ 
COPY/PASTE),  wenn  diese  nicht  fiir  das  oberste  Fenster  definiert  sind. 


BOOLEAN  is_top  (WINDOWP  window); 

Es  kann  getestet  werden,  ob  ein  bestimmtes  Fenster  ganz  oben  in  diesem  Prozel)  liegt. 
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is_top  : TRUE,  wenn  das  zu  testende  Fenster  oben  liegt 
window:  Zeiger  auf  das  Fenster,  welches  getestet  werden  soli 

Es  bietet  sich  an,  die  Funktion  zu  benutzen,  urn  festzustellen,  ob  bestimmte  Aktionen  an 
einem  Fenster  durchgefuhrt  werden  diirfen.  Beispielsweise  sollten  Fenster,  in  die  Einga- 
ben  gemacht  werden  kdnnen,  nur  auf  Eingaben  reagieren,  wenn  sie  ganz  oben  liegen. 
Sonst  wiirden  z.B.  beim  Schieben  (nach  rechts)  von  Fensterinhalten  eventuell  verdeckte 
Teile  mitverschoben. 


BOOLEAN  any_open  (BOOLEAN  incl_desk,  BOOLEAN  incl  closer); 

Es  kann  getestet  werden,  ob  irgendwelche  Fenster  offen  sind.  Dabei  kann  noch  spezifi- 
ziert  werden,  ob  der  Desktop  auch  zu  den  offenen  Fenstern  zahlt  (er  kann  meist  nicht 
geschlossen  werden),  oder  ob  das  Vorhandensein  der  SchlieBbox  beriicksichtigt  werden 
soli. 

any_open  : TRUE,  wenn  mindestens  ein  Fenster  dieses  Prozesses  offen  ist,  auf 
das  die  Spezifikation  zutrifft,  FALSE  sonst 
incLdesk  : TRUE,  wenn  der  Desktop  ebenfalls  beriicksichtigt  werden  soli,  FALSE 
sonst 

incl_closer:  TRUE,  wenn  nur  Fenster  beriicksichtigt  werden  sollen,  die  auch  eine 
SchlieBbox  haben,  FALSE  sonst 

Von  dieser  Funktion  kann  z.B.  das  Ein/Ausschalten  eines  Mentis,  welches  „SchlieBen“ 
heiBt,  abhangig  gemacht  werden  (siehe  auch  Modul  MENU). 


WORD  num_windows  (WORD  class,  WORD  mode,  WINDOW?  winds  []); 


Die  Anzahl  der  Fenster  einer  oder  aller  Klassen  kann  ermittelt  werden.  Dabei  kann  noch 
angegeben  werden,  ob  offene  oder  geschlossene  Fenster  berucksichtigt  werden  sollen. 
Ein  zusatzlicher  Parameter  gibt  alle  Fensterzeiger  zuriick,  so  daB  mit  alien  gefundenen 
Fenstern  Operationen  durchgefuhrt  werden  kdnnen. 


num_windows 

class 

mode 


winds 


Anzahl  der  Fenster,  auf  die  die  Spezifikationen  zutreffen 
Klasse  der  Fenster  oder  NIL,  wenn  die  Klasse  keine  Rolle  spielt 
Modus,  in  dem  sich  die  Fenster  befinden: 

SRCH_CLOSED : Es  werden  geschlossene  Fenster  gesucht 

SRCH_OPENED:  Es  werden  gedffnete  Fenster  gesucht 

SRCH_ANY  : Beide  eben  genannten  Mdglichkeiten 

Zeiger  auf  ein  Feld  von  Fensterzeigern,  die  auf  die  gefundenen  Fenster 

deuten,  oder  NULL,  wenn  man  die  Fenster  nicht  weiterverarbeiten 

mdchte 
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Beispiele  finden  sich  in  fast  alien  Modulen.  Es  wird  jeweils  die  Anzahl  der  Fenster  einer 
Klasse  ermittelt,  damit  zwei  Fenster  einer  Klasse,  die  hintereinander  geoffnet  werden, 
nicht  direkt  ubereinander  zu  liegen  komraen. 

Urn  die  Anzahl  aller  Fenster  der  Klasse  CLASS_META  zu  ermitteln,  die  offen  sind, 
mull  z.B. 

num  = num_windows  (CLASS_META,  SRCH_OPENED,  NULL); 

aufgerufen  werden.  Soil  das  Innere  aller  dieser  offenen  Fenster  neu  gezeichnet  werden, 
so  miissen  die  Fenster  in  einem  Feld  abgespeichert  werden. 

num  = num_ windows  (CLASS_META,  SRCH_OPENED,  winds); 
for  (i  = 0;  i < num;  i++)  redraw_window  (winds  [i],  &desk); 

Dabei  muB  „winds“  ein  Feld  sein,  daB  Platz  fur  maximal  8 Fenster  hat  (maximale  Anzahl 
offener  Fenster  in  GEM),  also  z.B. 

WINDOWP  winds  [MAX_GEMWIND]; 


WINDOWP  create_window  (UWORD  kind,  WORD  class); 

Fine  neue  Inkarnation  einer  Klasse  wird  in  Form  eines  Fensters  kreiert.  Die  Art  und  Klas- 
se des  Fensters  wird  hier  bereits  festgelegt.  Alle  anderen  fur  das  Fenster  typischen  Varia- 
blen  und  Aktionen  werden  nach  dem  erfolgreichen  „create_ window"  initialisiert.  Nach 
dem  Kreieren  wird  das  Fenster  nicht  geoffnet. 

create_window:  Zeiger  auf  das  erzeugte  Fenster  oder  NULL,  wenn  kein  Speicherplatz 
mehr  fur  das  Fenster  zur  Verfugung  steht 
kind  : Art  der  Komponenten  eines  Fensters  (siehe  AES.H) 

class  : Klasse  des  Fensters 

Die  Anzahl  der  maximal  zu  kreierenden  Fenster  hangt  vom  zur  Verfugung  gestellten 
Speicherplatz  ab  (siehe  „init_windows“  weiter  unten).  1st  ein  Fenster  kreiert,  so  wird 
es  vom  Window-Manager  in  eine  Liste  aufgenommen,  in  der  alle  offenen  und  geschlosse- 
nen  Fenster  eingetragen  sind.  Da  das  Fenster  noch  nicht  geoffnet  ist,  steht  es  ganz  unten 
in  der  Liste.  Das  oberste  geoffnete  Fenster  steht  in  der  Liste  an  der  Stelle  mit  Index  0. 

Das  Kreieren  eines  Fensters  benotigt  noch  kein  GEM-Window-Handle.  Der  GEM-Aufruf 
„wind_create“  erfolgt  erst  beim  Offnen  des  Fensters.  Dadurch  konnen  auch  mehr  als 
acht  Fenster  erzeugt  werden.  Es  konnen  lediglich  nur  maximal  acht  Fenster  offen  sein. 


VOID  delete_window  (WINDOWP  window); 

Ein  Fenster  wird  geldscht  und  damit  aus  der  Liste  des  Window-Managers  entfemt.  Der 
freigewordene  Speicherplatz  wird  zum  Kreieren  neuer  Fenster  benutzt. 
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window;  Zeiger  auf  das  Fenster,  welches  geloscht  werden  soil  ' * at.M  - 

Bevor  das  Fenster  geloscht  wind  und  damit  eventuell  Datenstrukturen  freigegeben  wer- 
den, die  den  Fensterinhalt  anzeigen,  geschieht  eine  Testabfrage.  Dazu  muB  eine  Funktion 
in  der  Komponente  „test“  der  Fensterstruktur  eingcklinkt  sein.  Diese  Funktion  wird  dann 
mit  dem  Parameter  „window“  und  „DO  DELETE"  aufgerufen.  Liefert  sie  TRUE,  so 
wird  das  Fenster  endgultig  geloscht.  An  diese  Funktion  kann  man  also  z.B  eine  Alertbox 
hangen,  die  abfragt,  ob  das  Fenster  wirklich  geloscht  werden  soil. 

1st  das  Fenster  noch  offen,  wenn  es  geloscht  werden  soli,  so  wird  es  zunachst  geschiossen. 
Vor  dem  Freigeben  der  Datenstruktur  wird  die  Funktion  „delete“  aufgerufen,  die  in  der 
Fensterstruktur  eingeklinkt  werden  kann.  In  dieser  Funktion  konnen  noch  einmal  Daten 
gerettet  werden. 


BOOLEAN  open_ window  (WINDOWP  window); 

Ein  vorher  kreiertes  Fenster  wird  gedffnet.  Auch  ein  bcreits  offenes  Fenster  kann  noch 
einmal  gedffnet  werden  (mehrstufiges  Offnen).  Es  muB  dann  auch  genauso  oft  geschios- 
sen werden,  wie  es  gedffnet  wurde.  Ahnliches  gilt  fur  den  Desktop,  bei  dem  ein  Klicken 
auf  die  SchlieBbox  nicht  unbedingt  bedeutet,  daB  das  Fenster  tatsachlich  geschiossen 
wird.  Vielmehr  wird  doit  urn  eine  Ebene  zuriickgegangen. 

open_window:  TRUE;  wenn  das  Offnen  des  Fensters  geklappt  hat,  FALSE  sonst 
window  ; Zeiger  auf  das  Fcn.ster,  Welches  gedffnet  werden  soil 

War  das  Fenster  noch  nicht  offen,  so  wird  mittels  „wind_create“  ein  neues  Fenster  an- 
gelegt.  Dies  gilt  aber  nur  fur  den  Fall,  daB  es  sich  um  ein  richtiges  Fenster  handelt.  Ein 
eigener  Desktop  wird  insofern  beriicksichtigt,  als  kein  „wind_create“  aufgerufen  wird. 
AuBerdem  wird  das  Handle  auf  0 gesetzt. 

1st  bereits  ein  anderes  Fenster  des  gleichen  Prozesses  offen,  so  wird  fiir  dieses  die  Funk- 
tion „untop“  der  Fensterstruktur  aufgerufen,  da  es  nach  unten  kommt.  Dann  wird  fiir 
das  zu  dffnende  Fenster  die  Funktion  „open“  der  Fensterstruktur  aufgerufen.  1st  das  Fen- 
ster nun  der  Desktop,  wird  es  automatisch  beim  AES  angemeldet,  ansonsten  wird  das 
Fenster  normal  gedffnet,  wobei  vorher  Name,  Infozcilc  und  Schieber  gesetzt  werden.  An- 
schlieBend  wird  es  noch  in  die  Liste  des  Window-Managers  eingetragen. 


VOID  close_.window  (WINDOWP  window); 

Ein  zuvor  gedffnetes  Fenster  wird  geschiossen.  Auf  ein  bereits  geschlossenes  Fenster  hat 
die  Funktion  keine  Wirkung. 


window:  Zeiger  auf  das  Fenster,  welches  geschiossen  werden  soli 
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Vor  deni  Schliel3cn  wird  zunachst  die  Funktion  „test“  mit  den  Parametern  „window“  und 
„DO  CLOSE"  der  Fensterstruktur  aufgerufen.  Existiert  keine  solche  Funktion  oder 
liefert  diese  den  Wert  TRUE  zuriick,  so  wird  mit  dcm  Schliefien  des  Fensters  fortgefah- 
ren.  An  diese  Funktion  kann  z.B.  eine  Alertbox  gehangt  werden,  die  abfragt,  ob  das  Fen- 
ster  auch  wirklich  geschlossen  werden  soil. 

War  das  Fenster  sclektiert,  so  wird  es  zunachst  deselektiert.  1st  das  Fenster  der  Desktop, 
so  wird  es  beim  AES  abgemeldet.  Damit  erscheint  wieder  der  vor  dem  Programmstart 
bekannte  Desktop.  Ansonsten  wird  das  Fenster  geschlossen.  Wurde  das  Fenster  niehrstu- 
fig  geciffnet,  so  verschwindet  es  aber  erst  dann  vom  Bildschirm,  wenn  es  zum  letzten  Mai 
geschlossen  wird.  Fiir  die  alte  GEM-Version  wird  noch  das  Schliefien  t'iir  Accessory- 
Fenster  beriicksichtigt.  Falls  das  Accessory  die  Meldung  AC_CLOSE  erhiilt,  durfen  die 
Fenster  weder  geschlossen  noch  geloscht  werden,  da  sonst  der  Rechner  gnadenlos  ab- 
sturzt  Oder  hangenbleibt. 

Nun  wird  die  Funktion  „closc“  der  Fensterstruktur  aufgerufen.  An  dieser  Stelle  konnen 
bestimmte  Aktionen  getatigt  werden,  wie  z.B.  das  Zeichnen  einer  schrumpfenden  Box 
Oder  das  Abspeichern  eines  Dokumentes. 

Wird  das  Fenster  zum  letzten  Mai  geschlossen,  so  wird  es  geloscht,  wenn  das  Flag 
WI_RESIDENT  nicht  gesetzt  war.  Es  laufen  dann  die  gleichen  Aktionen  wie  bei 
„delete_window“  ab. 

Falls  nun  ein  anderes  Fenster  dieses  Prozesses  nach  oben  kommt,  wird  fur  dieses  die 
Funktion  „top“  der  Fensterstruktur  aufgerufen.  .. 

VOID  close_top  (VOID);  ^ 

Das  oberste  Fenster  wird  geschlossen.  Dabei  spielt  es  keine  Rolle,  ob  dieses  Fenster  eine 
SchlieBbox  hat  oder  nicht.  Wurde  das  Fenster  mehrstufig  geoffnet,  so  wird  um  eine  Stufe 
zuriickgegangen. 

VOID  close  all  (BOOLEAN  delete,  BOOLEAN  close_desk);  •' 

Es  werden  alle  Fenster  geschlossen  und/oder  geloscht.  Dabei  kann  angegeben  werden, 
ob  der  Desktop  ebenfalls  geschlossen  werden  soil  oder  nicht. 

delete  : TRUE,  wenn  die  Fenster  nach  dem  SchlieBen  auch  geloscht  werden  sollen, 
FALSE  sonst 

close_desk  : TRUE,  wenn  der  Desktop  mit  geschlossen  werden  soil,  FALSE  sonst 


VOID  draw_window  (WINDOW?  window);  ' ' ' ■ ' • ' ''  ' 

Der  Fensterinhalt  wird  gczeichnet.  Soil  nur  ein  Teil  gczeichnet  werden,  so  muB  vorher 
das  Clipping  gesetzt  werden.  Die  Rechteckliste  wird  hier  nicht  beriicksichtigt. 
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window:  Zeiger  auf  das  Fenster,  welches  gezeichnet  werden  soil  ’5 '■  ■ ' 

Da  der  Window-Manager  nicht  weiB,  was  sich  genau  im  Fenster  befindet,  wird  die  Routi- 
ne „draw“  der  Fensterstruktur  aufgerufen.  In  dieser  Routine  entscheidet  die  Applikation, 
was  gezeichnet  werden  soli.  1st  ein  Objektbaum  ins  Fenster  eingeklinkt,  so  wird  dieser 
automaiisch  gezeichnet.  • 


VOID  redraw_window  (WINDOW?  window,  CONST  RECT  *area); 

Ein  bestimmter  Bereich  eines  Fensters  wird  unter  Beriicksichtigung  der  Rechteckliste  neu 
gezeichnet.  Die  Maus  wird  automatisch  versteckt. 

window:  Zeiger  auf  das  Fenster,  welches  gezeichnet  werden  soil  . 

area  : Zeiger  auf  den  Bereich,  welcher  gezeichnet  werden  soil  ' 

Das  Clipping  des  Bereichs  wird  gesetzt.  bevor  das  Fenster  gezeichnet  wird.  Hat  das  Fen- 
ster eine  Meniizeile,  so  wird  diese  automatisch  gezeichnet. 


VOID  top_window  (WINDOW?  window); 


Ein  Fenster  wird  nach  oben  gebracht. 

window:  Zeiger  auf  das  Fenster,  welches  nach  oben  gebracht  werden  soil 


1st  das  Flag  „WI_NOTO?“  in  der  Fensterstruktur  gesetzt,  so  wird  das  Fenster  nicht 
nach  oben  gebracht.  Fiir  das  alte  GEM  wird  zusatzlich  noch  die  Meldung 
„WM  UNTO?PED“  dermaBen  simuliert,  daB  das  zweitoberste  Fenster  vorher  „nach 
unten  gebracht  wird“,  d.h.  von  diesem  Fenster  wird  die  Funktion  „untop“  der  Fenster- 
struktur angesprungen.  Bei  neueren  GEM-Versionen  (ab  2.X),  wird  vom  GEM  die  Mel- 
dung „WM_UNTOPPED“  gebracht,  so  daB  die  entsprechende  Routine  vom  Event- 
Manager  aufgerufen  wird. 


Fiir  das  Fenster,  welches  nach  oben  gebracht  werden  soil,  wird  die  Funktion  „top“  der 
Fensterstruktur  aufgerufen.  An  dieser  Stelle  konnen  Aktionen  ablaufen  wie  das  Restaurie- 
ren  von  Zustanden,  die  geherrscht  haben,  bevor  das  Fenster  nach  unten  gekommen  ist. 


VOID  untop_window  (WINDOW?  window); 

Ein  Fenster,  welches  nach  unten  gebracht  wird,  kann  eine  Aktion  durchfiihren. 
window:  Zeiger  auf  das  Fenster,  welches  nach  unten  gebracht  wird  • 
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Die  Funktion  wird  normaierweise  nur  vom  Event-Manager  (siehe  Modul  EVENT)  aufge- 
rufen,  wenn  dieses  die  Meidung  „WM_UNTOPPED"  bekommen  hat.  Dann  kann  das 
Fenster,  wdchesmchmtenkommt,  noch  eine Akt'ion dvrchfuhren  (z.B.  Retten des Fen- 
sterinhaltes,  etc.). 


VOID  scrolL window  (WINDOWP  window,  WORD  dir,  LONG  delta); 


Der  Inhalt  eines  Fensters  wird  um  eine  beliebige  Anzahl  von  Pixeln  in  eine  von  vier  Rich- 
tungen  gescrollt.  Die  Mans  wird  automatisch  versteckt. 


window:  Zeiger  auf  das  Fenster,  welches  gescrollt  werden  soli 
dir  : Richtung,  in  die  gescrollt  werden  soli,  namlich 
HORIZONTAL:  Links-Rechts-Scrolling 
VERTICAL  : Aufwarts-Abwiirts-Scrolling 
delta  : Anzahl  der  Pixel,  um  die  gescrollt  werden  soil,  wobei  gilt: 
Richtung  HORIZONTAL  und  delta  > 0 Links-Scrolling 

Richtung  HORIZONTAL  und  delta  > 0 Rechts-Scrolling 

Richtung  VERTICAL  und  delta  >0  = Aufwarts-Scrolling 
Richtung  VERTICAL  und  delta  <0  Abwarts-Scrolling 


Die  Funktion  beriicksichtigt  verschiedene  Sonderfalle.  Wird  ein  Scrolling  mit  einem  Wert 
„delta“  aufgerufen,  der  grofier  ist  als  der  scrollbare  Fensterbereich,  so  wird  nicht  ge- 
scrollt, sondern  der  Scrollbereich  des  Fensters  gleich  neu  gezeichnet.  Dies  kommt  immer 
dann  vor,  wenn  der  Benutzer  den  Schieber  um  mehr  als  eine  Seite  bewegt. 


Im  anderen  Fall  wird  exakt  berechnet,  wie  viele  Pixel  gescrollt  werden  mtissen.  Dies  gilt 
vor  allem  dann,  wenn  das  Fenster  nicht  mehr  ganz  im  Desktop  liegt,  da  hier  Informatio- 
nen,  die  sonst  durch  Scrolling  verftigbar  sind,  durch  den  Desktop  „weggeclippt“  sind. 
Die  fehlende  Information  wird  spater  durch  ein  entsprechendes  Redraw  verlangt.  Viele 
Programme  (z.B.  die  Editoren  von  Turbo  C Oder  Laser  C)  sind  offensichtlich  auCerstan- 
de,  den  Fensterinhalt  zu  scrollen,  wenn  dieser  nur  teilweise  im  Desktop  liegt.  Sie  restau- 
rieren  dann  jeweils  den  gesamten  Fensterinhalt,  was  jedoeh  sehr  langsam  ist. 


Das  Scrolling  selbst  geschieht  unter  Zuhilfenahme  der  Rechteckliste.  Dann  geschieht, 
wenn  das  Fenster  ganz  sichtbar  ist,  ein  echtes  Scrolling  und  zwar  unabhangig  davon,  wo 
das  Fenster  liegt.  Das  bedeutet,  dal)  auch  im  Hintergrund  gescrollt  werden  kann.  Wird 
das  Fenster  von  vielen  anderen  Fenstern  verdeckt,  ist  dieser  Algorithmus  nicht  mehr  an- 
wendbar,  da  Information,  die  durch  Scrolling  verfiigbar  sein  miifSte,  nicht  mehr  existiert 
(z.B.  Aufwarts-Scrolling,  wenn  die  unteren  oder  oberen  Zeilen  eines  Fensters  teilweise 
durch  ein  anderes  verdeckt  sind).  In  diesem  Fall  geschieht  das  Scrolling  durch  permanen- 
tes  Zeichnen  des  Fensterinhaltes.  Das  ist  zwar  nicht  so  schnell,  aber  es  funktioniert. 
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VOID  arrow_window  (WINDOW?  window,  WORD  arrow,  WORD  amount); 

Bin  Fenster  reagiert  auf  das  Anklicken  eines  Pfeils.  ' 

window:  Zeiger  auf  das  Fenster,  dessen  Pfcilc  angcklickt  warden 
arrow  : Pfeil,  der  angeklickt  wurde,  wobei  gilt  (sichc  AES.H): 

WA_UPPAGE:  Seite  nach  oben 
WA_DNPAGE:  Seite  nach  unten 
WA_UPLINE:  Zeile  nach  oben 
WA„ ONLINE:  Zeile  nach  unten 
WA„LFPAGE:  Seite  nach  links 
WA  RTPAGE:  Seite  nach  rechts 
WA_LFLINE:  Zeile  nach  links 
WA_RTLINE:  Zeile  nach  rechts 
amount : Anzahl  der  Einheiten,  um  die  gescrollt  werden  soil 

Nachdcm  der  Benutzer  einen  Pfeil  angeklickt  hat,  sollte  diese  Routine  vom  Event- 
Manager  (Modul  EVENT)  aufgerufen  werden.  Jc  nach  Wert  des  Parameters  „arrow“ 
wird  die  neue  Position  innerhalb  des  Dokumentes  berechnet.  Falls  die  neue  Position  iiber 
den  Rand  hinausgeht,  wird  dies  korrigiert.  So  fiihrt  das  Anklicken  des  Aufwarts-Pfeils 
nicht  zu  einem  Scrolling  oder  Neuzeichnen  des  Fensterinhalts,  wenn  bereits  der  obere 
Rand  erreicht  ist.  Einige  Programme  tun  dies  aber  trotzdem. 

Nachdem  die  neue  Position  berechnet  wurde,  wird  die  Funktion  „arrow“  der  Fenster- 
struktur  mit  den  Parametern  „window“,  „dir“,  „oldpos“  und  „ncwpos“  aufgerufen. 
Letztere  geben  die  alte  und  neue  Position  in  den  Einheiten  an,  die  durch  die  Variablen 
„window->xfac“  bzw,  „window->yfac“  festgelegt  wurden.  In  dieser  Funktion  des  Fen- 
sters  kann  nun  entsprechend  reagiert  werden.  Beispielsweise  konnen  dort  neue  Zeilen  fiir 
das  Redraw  zur  Verfugung  gestellt  werden  oder  neue  Datensiitze  einer  Datenbanklistc  gc- 
holt  werden  u.s.w.  Beispiele  sind  in  alien  Modulcn  angegeben,  in  denen  Fenster  gescrollt 
werden  konnen. 

Ist  ein  Objektbaum  in  das  Fenster  eingeklinkt,  so  geschieht  das  Reagieren  auf  die  Pfeile 
automatisch. 


VOID  h_slider  (WINDOW?  window,  WORD  new_value); 

Ein  Fenster  reagiert  auf  das  Bewegen  des  horizontalen  Schicbers. 

window  : Zeiger  auf  das  Fenster,  dessen  Schieber  bewegt  wurde 

new  value:  Vom  GEM  gelieferter  neuer  Wert  fiir  den  Schieber  (0  - 1000) 

Nachdem  der  neue  Schieberwert  berechnet  wurde,  wird  wie  beim  Anklicken  eines  hori- 
zontalen Pfeils  reagiert. 
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VOID  v_slider  (WINDOW?  window,  WORD  new_value); 

Ein  Fenster  reagiert  auf  das  Bewegen  des  vertikalen  Schiebers. 

window  : Zcigcr  auf  das  Fenster,  dessen  Schieber  bewegt  wurde 
ncw_valuc  ; Vom  GEM  gclicfcrtcT  ncucr  Wert  fur  den  Schicber  (0  — 1000) 

Nachdern  der  neiie  Schieberwert  berechnel  wiirde,  wird  wie  beim  Anklicken  eines  verti- 
kalen Pfeils  reagiert. 


VOID  set  ..sliders  (WINDOW?  window,  WORD  which,  WORD  mode); 

Die  Schieberpositionen  und/oder  die  Schiebergrollen  werden  gesetzt. 

window : Zeiger  auf  das  Fenster,  dessen  Schieber  gesetzt  werden  sollen 
which  : Angabe  der  Schieber,  wobei  gilt 

HORIZONTAL:  Horizontaler  Schieber 
VERTICAL  : Vertikaler  Schieber 
mode  : Operation,  die  durchgefiihrt  werden  soli,  wobei  gilt 
SLPOS  : Position  des  Schiebers  neu  setzen 
SLSIZE:  GroBe  des  Schiebers  neu  setzen 

Beim  Aufruf  kdnnen  allc  Kombinationen  benulzt  werden,  so  da6  Position  und  GroBe  von 
beiden  Schiebern  in  einem  Durchgang  veriindert  werden  kdnnen.  Der  Aufruf  wiirde  dann 
lauten 

set^sliders  (window,  HORIZONTAL  + VERTICAL,  SLPOS  + SLSIZE); 

Das  Zeichnen  der  Schieber  wird  optimiert,  so  daft  die  Schieber  nur  dann  neu  gezeichnet 
werden,  wenn  sich  ihr  Wert  tatsachlich  geiindert  hat.  Zwei  aufeinanderfolgende  Aufrufe 
von  „set  sliders"  ergibt  somit  kein  unruhiges  Zucken  der  Schieber  auf  dem  Bildschirm. 
Dies  ist  sonst  haufig  der  Fall,  wenn  die  Aufldsung  der  Schieber  (1000  Punkte)  nicht  aus- 
reicht,  also  z.B.  mehr  als  1000  Zeilen  oder  Spalten  in  einem  Fenster  stehen. 


VOID  snap_window  (WINDOW?  window,  RECT  *new,  WORD  mode); 

Ein  Fenster  wird  auf  bestimmte  Positionen  des  Bildschirms  eingerastet.  Dies  ist  fur  Zei- 
chenoperationen  sinnvoll.  Zeichenketten  werden  auf  Bytegrenzen  schneller  gezeichnet, 
da  der  Rechner  dann  kcinc  Bit-Schicbc-Opcrationcn  ausfuhrcn  mu6.  AuBerdem  miissen 
sich  Menuzeilen  immer  auf  geraden  Y-Positionen  befinden,  da  .sonst  das  Muster,  welches 
Mcniicintrage  grau  darstellt,  bestimmte  Buchstaben  entstellen  wiirde.  Dariiberhinaus  soil- 
ten  sich  bestimmte  Muster  (z.B.  das  „Grau“  des  Desktops)  ebenfalls  immer  auf  geraden 
X-  und  Y-Positionen  befinden. 

window:  Zeiger  auf  das  Fenster,  welches  eingerastet  werden  soli 
new  : Zeiger  auf  ein  Rcchteck,  welches  zunachst  die  aktuelle  und  nach  dem  Veran- 
dern  die  neue  Position  angibt 
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mode  : Art  des  Einrastcns.  entweder  nach  dem  Verschieben  oder  nach  dem  Vergro- 
Bern/Verkleinern  des  Fensters,  wobci  gilt 
MOVED:  Das  Fenster  wurde  bewegt 
SIZED  : Das  Fenster  wurde  vergroBert  oder  verkleinert 

Die  Funklion  wild  nach  dem  Verschieben  oder  VergroBern/Verkleinern  vom  Window- 
Manager  aufgerufen.  Zunachst  wird  abgepriift,  ob  dcr  linke  Rand  des  FensterauBeren  ge- 
nau  am  linken  Bildschirmrand  liegt.  1st  dies  der  Fall,  so  wird  das  Fenster  urn  eine  weitere 
Position  ins  Negative  verschoben.  Da  der  Rand  des  Fensters  genau  ein  Pixel  breit  ist, 
kommt  das  Fensterinnere  dabei  genau  an  der  X-Position  null  zu  liegen.  Damit  kann  das 
Fensterinnere  leicht  auf  Bytegrenzcn  einrasten,  ohne  dafi  sieben  Bits  verlorengehen . 

Verschiedcnc  Programme  wie  z.B.  Tcmpus  gehen  auf  ahnliche  Art  vor.  Bei  anderen  Pro- 
grammen  wie  z.B.  Turbo-C  ist  es  nicht  moglieh,  das  Fenster  an  den  linken  Rand  zu  schie- 
ben,  da  dieses  nicht  um  eine  weitere  Position  nach  links  gebracht  werden  kann,  so  dafi 
das  Fensterinnere  nicht  auf  einer  Bytegrenze  zu  liegen  kommt.  Aus  diesem  Grund  kann 
man  das  Fenster  nicht  ganz  an  den  linken  Rand  schieben,  es  gehen  immer  sieben  Pixel 
an  Verschiebcmdglichkeiten  verloren. 

Die  Funktion  verhindert  auBerdem,  daB  ein  Fenster  zu  klein  werden  kann.  Wahrend  Fen- 
ster mit  Schiebern  nicht  unter  eine  bestimmte  Minimalgrdfie  gebracht  werden  kdnnen, 
ist  dies  bei  Fenstern  ohne  Schieber  nicht  der  Fall.  Unterschreitet  die  neue  GroBe  bestimm- 
te Grenzen  (MIN  WIDTH  und  MIN_HEIGHT),  so  werden  diese  korrigiert. 

Danach  wird  die  Funktion  „snap“  der  Fensterstruktur  aufgerufen.  Dort  kann  jedes  Fen- 
ster fiir  sich  entscheiden,  welchc  Aktionen  beim  Einrasten  durchgefuhrt  werden  sollen. 
So  kann  z.B.  beim  VergroBern  eines  Fensters  unter  den  unteren  Rand  eines  Dokumentes 
die  Y-Position  innerhalb  des  Dokuments  (doc.y)  verkleinert  werden,  so  daB  das  Fenster 
wiedcr  den  unteren  Rand  des  Dokumentes,  jedoch  nun  mehr  Zeilen  als  vorher  anzeigt. 

Bei  den  Einrastaktionen  der  Fenster  werden  jeweils  nur  Differenzen  berechnet,  keine  ab- 
soluten  Positionen.  So  kann  das  Fenster  leichter  entscheiden,  wieviele  Zeilen  oder  Spalten 
nun  dazu-  oder  weggekommen  sind.  Da  jeweils  immer  nur  Differenzen  benutzt  werden, 
muB  sich  das  Fenster  beim  erstmaligen  Offnen  auf  einer  der  Positionen  befinden,  auf  die 
jeweils  eingerastet  werden  soli. 


VOID  full,  window  (WINDOWP  window); 

Das  Fenster  reagiert  auf  das  Anklicken  der  Full-Box  in  der  rcchten  oberen  Ecke. 

window:  Zeiger  auf  das  Fenster,  dessen  Full-Box  angeklickt  wurde 

Der  Window-Manager  sorgt  von  selbst  dafiir,  daB  das  Fenster  nur  dann  auf  voile  GroBe 
gebracht  wird,  wenn  es  vorher  geoffnet,  bewegt.  vergroBert  oder  verkleinert  wurde.  Das 
Zeichnen  der  Grow-  und  Shrinkbox  wird  fiber  die  globalen  Funktionen  ,.growbox“  und 
„shrinkbox“  aufgerufen,  so  daB  mittels  der  globalen  Variablen  „grow_shrink“  eingc- 
stellt  werden  kann,  ob  die  Boxen  gezeichnet  werden  oder  nicht. 


440 


6 Ein  universelles  Modulkonzept  in  C 


VOID  size_window  (WINDOW?  window,  CONST  RECT  *new); 

Das  Fenster  reagiert  auf  ein  VergroBern  oder  Verkleinern. 

window:  Zeiger  auf  das  Fenster,  welches  vergroBert  oder  verkleinert  wird 
new  : Zeiger  auf  das  Rechteck,  welches  die  gewunschte  neue  GroBe  des  Fensters 
angibt 

Bevor  die  neue  GroBe  des  Fensters  gesetzt  wird,  wird  dem  Fenster  die  Moglichkeit  gege- 
ben,  via  „snap_window“  zu  bestimmen,  ob  das  Fenster  auf  bestimmte  Positionen  ein- 
gerastet  werden  soil.  Die  Schieber  des  Fensters  werden  automatisch  gesetzt. 


VOID  move_window  (WINDOW?  window,  CONST  RECT  *new); 

Das  Fenster  reagiert  auf  ein  Bewegen. 

window : Zeiger  auf  das  Fenster,  welches  bewegt  wird 

new  : Zeiger  auf  das  Rechteck,  welches  die  gewuschte  neue  Position  des  Fensters 
angibt 

Bevor  die  neue  Position  des  Fensters  gesetzt  wird,  wird  dem  Fenster  die  Moglichkeit  ge- 
geben,  via  „snap_window“  zu  bestimmen,  ob  das  Fenster  auf  bestimmte  Positionen 
eingerastet  werden  soli.  Die  Schieber  des  Fensters  werden  automatisch  gesetzt. 


WORD  drag_to_window  (WORD  mox,  WORD  moy, 

WINDOW?  sre  window,  WORD  src.._obj, 
WINDOW?  *dest_window,  WORD  *dest_obj); 


Das  Ziehen  von  Objekten  aus  einem  Fenster  in  ein  anderes  wird  unterstiitzt. 


drag_to_window  : 

DRAG_OK 
DRAG_SWIND  : 
DRAG_SCLASS  : 


DRAG_NOWIND : 


DRAG_NORCVR : 


Ergebnis  der  Ziehoperation,  wobei  folgende  Konstanten  vor- 
definiert  sind: 

Die  Drag-Operation  ist  ok. 

Das  Objekt  wurde  innerhalb  des  gleichen  Fensters  verschoben. 
Das  Objekt  wurde  auf  ein  Fenster  der  gleichen  Klasse  gezogen,  also 
z.B.  von  einem  Dateifenster  in  ein  anderes,  aber  nicht  von  einem 
Dateifenster  in  ein  Papierkorbfenster. 

Das  Zielfenster,  in  welches  das  Objekt  gezogen  wurde,  gehort  nicht 
zum  gleichen  ProzeB,  kann  also  z.B.  ein  Fenster  von  einem  Desk- 
accessory  sein.  In  einer  Multitasking-Umgebung  sollte  dem  frem- 
den  ProzeB  mittels  „wind_aprmd“  eine  Nachricht  gesendet 
werden. 

Das  Zielfenster  gehort  zwar  zum  eigenen  ProzeB,  stellt  aber  keine 
Routine  zur  Verfiigung,  um  Drag-Operationen  auszuwerten. 
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DRAG_NOACTN : 

mox  : 

moy  : 

src  window  : 

src  obj 

dest_window  : 

dcst  obj  : 


Das  Zielfenster  besitzt  zwar  eine  Routine,  welche  auf  eine  Drag- 
Operation  reagiert,  kann  aber  mit  dem  Objekl  nichts  anfangen. 
X-Koordinate  dcr  Maus  beim  Beenden  der  Zieh-Operation 
Y-Koordinate  der  Maus  beim  Beenden  der  Zieh-Operation 
Zeiger  auf  das  Quellfenster  der  Zieh-Operation 
Nummer  des  Objekts,  welches  gezogen  wird 
Zeiger  auf  den  Zeiger  auf  das  Zielfenster  odcr  NULL,  wenn  kein 
Zielfenster  dieses  Prozesses  existiert 

Zeiger  auf  das  Zielobjekt  oder  NIL,  wenn  kein  Zielobjekt  existiert 


Bei  einer  Zieh-Operation  ruft  das  Fenster,  in  welchem  Objekte  angeklickt  und  verschoben 
wurden,  die  oben  beschriebene  Funktion  auf.  Dabei  werden  die  aktuellen  Maus- 
Koordinaten  sowie  das  Quellfenster  iibergeben.  Falls  die  Objekte  nicht  der  gleichen  Klas- 
se  angehoren,  sollte  fiir  jedes  Objekt  (src_  obj)  die  Operation  jcweils  aufgerufcn  wer- 
den. Dies  liegt  daran,  dall  beim  Verschieben  von  Objekten  unterschiedlicher  Art  eventuell 
verschiedene  Operationen  ausgefiihrt  werden  miissen.  So  hat  das  gleichzeitige  Verschie- 
ben des  Klerambretts  und  des  Diskettensymbols  in  das  Papierkorbfenster  jeweils  unter- 
schiedliche  Aktionen  zur  Folge. 

Der  Algorithmus  lauft  nun  folgendermafien  ab:  Zunachst  wird  das  Zielfenster  aus- 
findig  gemacht.  Gehort  dieses  nicht  zum  eigenen  Prozefl,  so  wird  der  Wert 
„DRAG_NOWIND“  zuriickgegeben. 


Danach  wird  das  Zielobjekt  ausfindig  gcmacht,  falls  innerhalb  des  Fensters  ein  Objekt- 
baum  eingeklinkt  ist.  Ansonsten  erhalt  „dest_obj“  den  Wert  NIL. 


1st  nun  in  das  Zielfenster  eine  Funktion  „drag“  in  die  Fensterstruktur  eingeklinkt,  so  wird 
diese  aufgerufen.  Sie  erhalt  als  Parameter  das  Quellfenster,  das  Quellobjekt,  das  Zielfen- 
stcr  und  das  Zielobjekt.  Damit  kann  das  Zielfenster  auf  die  Zieh-Operation  reagieren. 
Dessen  Ruckgabewert  wird  wiederum  an  das  Quellfenster  geliefert,  das  nun  ebenfalls 
reagieren  kann.  Das  Zielfenster  sollte  je  nach  Objekttyp  entsprechende  Werte  zuriicklie- 
fern.  Es  kann  dabei  die  oben  beschriebenen  Standardwerte  benutzen  oder  eigene  Werte, 
die  groller  als  null  sein  sollten.  Durch  Benutzung  der  gleichen  Werte  kbnnen  sich  Quell- 
und  Zielfenster  somit  gegenseitig  absprechen,  so  daB  nur  das  Quell-,  nur  das  Ziel-  oder 
beide  Fenster  reagieren. 

Ist  keine  Funktion  „drag“  eingeklinkt,  .so  ist  der  Empfanger  wohl  desinteressiert,  weshalb 
der  Wert  „DRAG_NORCVR“  zuriickgeliefert  wird, 

Beispiele  der  Anwendung  dieser  Funktion  sind  in  den  Modulen  CLIPBRD  und  DESK- 
TOP gegeben. 


VOID  click_window  (WINDOWP  window,  MKINFO  *mk); 

Ein  Fenster  wurde  vom  Benutzer  angeklickt  (selekticrt). 

window:  Zeiger  auf  das  Fenster,  welches  angeklickt  wurde 
mk  ; Zeiger  auf  die  Maus-  und  Tastaturinformation 


442 


6 Bin  universelles  Modulkonzept  in  C 


Klickt  der  Benutzer  auf  ein  Fenster,  so  wird  vom  Modul  EVENT  diese  Funktion  aufgeru- 
fen.  Falls  eine  Funktion  ,.click“  in  die  Fensterstruktur  eingeklinkt  wurde,  so  wird  diese 
mit  den  Parametern  „window“  und  „mk“  aufgerufen.  Das  Fenster  kann  nun  Objekte  se- 
Icktiert,  also  z.B.  invers  darstellen.  Das  Deseicktieren  eines  anderen  angewahlten  Fen- 
sters  muB  in  dieser  Funktion  stattfinden.  Wiirde  dies  automatisch  vorher  geschehen,  so 
kdnnte  z.B.  der  Desktop  beim  Anklicken  einer  Funktionstaste  nicht  mehr  feststellen,  ob 
ein  Objekt  in  einem  anderen  Fenster  bereits  angeklickt  wurde,  auf  das  die  Funktionstaste 
reagieren  muB. 

Existiert  keine  Funktion  „click“,  so  wird  automatisch  das  zuletzt  selektierte  Fenster  dese- 
lektiert,  falls  es  nicht  das  angeklickte  Fenster  war. 


VOID  unclick_window  (WINDOWP  window); 

Ein  Fenster  wird  deselektiert.  Diese  Funktion  ist  das  Gegenstiick  zu  „click_ window". 

window:  Zeiger  auf  das  Fenster,  welches  deselektiert  werden  soil 

Die  Funktion  „unclick“  der  Fensterstruktur  wird  aufgerufen,  falls  sie  vorhanden  ist.  In 
dieser  mussen  die  Objekte,  die  in  diesem  Fenster  selektiert  sind,  deselektiert  werden. 
Danach  werden  die  globalen  Variablen  „sel_ window"  und  „sel_objs“  zuriickgesetzt. 


BOOLEAN  key_window  (WINDOWP  window,  MKINFO  *mk); 

Der  Benutzer  hat  eine  Taste  gedriickt,  welche  an  ein  Fenster  weitergeleitet  wird. 

key_ window:  TRUE,  wenn  das  Fenster  den  Tastendruck  verarbeitet  hat.  F.ALSE  sonst 
window  : Zeiger  auf  das  Fenster,  ftir  welches  der  Tastendruck  bestimmt  ist 

mk  : Zeiger  auf  die  Maus-  und  Tastaturinformation 

Der  Tastendruck  wird  nur  an  das  Fenster  geleitet,  wenn  es  offen  ist  und  zusatzlich  die 
Funktion  „key“  der  Fensterstruktur  gesetzt  ist.  In  diesem  Fall  wird  der  Funktionswert 
von  „key“  zuriickgeliefert,  FALSE  sonst.  Damit  kann  das  Fenster  entscheiden,  ob  es  auf 
einen  Tastendruck  reagieren  soli  (TRUE),  Oder  ihn  ignorieren  soli  (FALSE).  In  letzterem 
Fall  wird  der  Event-Manager  die  Information  an  das  nachste  Fenster  weiterleitcn,  wel- 
ches sich  ebenfalls  entscheiden  kann,  den  Tastendruck  zu  verarbeiten  oder  zu  ignorieren 
(siehe  „key_all“). 


BOOLEAN  key_all  (MKINFO  *mk); 

Eine  Tastenkombination  wird  alien  Fenstern  zur  Verarbeitung  angeboten. 

key_all:  TRUE,  wenn  mindestens  ein  Fenster  auf  eine  Taste  reagiert  hat,  FALSE  sonst 
mk  : Zeiger  auf  die  Maus-  und  Tastaturinformation 
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Der  Event-Manager  ruft  „key  all“  auf,  wann  immer  der  Benutzer  eine  Taste  gedriickt 
hat.  In  dieser  Funktion  werden  nun  alle  Fenster  abgearbeitet.  Zuerst  wird  dem  obersten 
Fcnster  die  Taste  angeboten.  Kann  dieses  Fenster  die  Taste  verarbeiten,  wird  es  den 
Funktionswert  TRUE  zuriickliefern,  und  die  Verarbeitung  wird  abgebrochen,  Ansonsten 
wird  dem  nachsten  Fenster  (von  oben)  die  Taste  angeboten.  Dies  wiederholt  sich,  bis  alle 
Fenster  abgearbeitet  wurden.  Das  letzte  Fenster  wird  meist  der  Desktop  sein. 

Beispiele  werden  in  alien  Fenstern  gegeben,  die  Tasten  verarbeiten.  Wichtig  fur  das  Ver 
arbeiten  von  Tasten  ist  es,  die  Taste  vor  allem  dann  an  das  nachste  untere  Fenster  weiter- 
zuleiten,  wenn  es  sich  um  eine  Funktionstaste,  Control-  oder  Alternate-Kombination  han- 
delt,  auf  die  noch  nicht  reagiert  wurde.  Dann  kann  am  Endc  der  Desktop  auf  die  Taste 
reagieren  und  entsprechende  Menus  konnen  ausgewahit  werden. 


VOID  timer_window  (WINDOW?  window); 

Der  Zeitvorgabe  fiir  ein  Fenster  ist  abgelaufen.  Dieses  kann  dann  darauf  reagieren. 

window:  Zeiger  auf  das  Fenster,  welches  auf  einen  Zeitablauf  reagieren  soli 

Die  Funktion  wird  von  „timer_all“  angesprungen,  damit  die  Fenster  auf  den  Zeitablauf 
reagieren  konnen.  Dies  geschieht  aber  nur,  wenn  eine  Funktion  in  die  Komponente  „ti- 
mer“  der  Fensterstruktur  eingeklinkt  ist.  Man  kann  sie  aber  auch  selbst  aufrufen,  um  den 
Zeitablauf  vorzeitig  zu  forcicren  (z.B.  dutch  einen  Tastendruck  oder  zu  Tcstzwecken). 


VOID  timer_all  (LONG  milli); 

Allen  Fenstern  wird  eine  Zeitscheibe  zur  Verfugung  gestellt,  in  denen  sie  Funktionen  aus- 
fiihren  konnen.  Damit  ist  eine  Art  Multitasking  innerhalb  eines  Programmes  moglich. 

milli:  Anzahl  der  Millisekunden.  die  seit  dem  letzten  Zeitereignis  vergangen  sind 

Die  Funktion  wird  vom  Event-Manager  aufgerufen,  wenn  dieser  auf  das  Eintreten  eines 
Zeitereignisses  gewartet  hat.  Die  Anzahl  der  dabei  verstrichenen  Millisekunden  wird  an 
diese  Funktion  iibergeben.  Sie  iiberpruft  dann  fiir  alle  Fenster  (von  obcn  angefangen), 
ob  die  Anzahl  der  Millisekunden,  auf  die  das  Fenster  gewartet  hat,  groBer  als  null  ist. 
In  diesem  Fall  wird  „milli“  zu  den  im  Fenster  verstrichenen  Millisekunden  (count)  hinzu- 
addiert.  Falls  dieser  Wert  den  im  Fenster  eingestellten  Wert  iiberschreitet,  so  wird  der 
Zahler  zuriickgesetzt  und  das  Zeitereignis  fiir  dieses  Fenster  ausgelost. 

Der  Timer,  der  von  der  Applikation  innerhalb  von  GEM  benutzt  wird,  ist  allerdings  fur 
kleine  Werte  nicht  sehr  genau,  da  die  Auflosung  zu  gering  ist.  Aus  diesem  Grund  bieten 
sich  Werte  um  100  Millisekunden  an,  die  eine  Applikation  warten  kann.  Diese  Werte 
stimmen  recht  genau  mit  der  tatsachlich  verstrichenen  Zeit  iiberein.  Falls  dieser  Wert  zu 
groB  ist,  das  Fenster  also  offer  als  jede  zehntel  Sekunde  eine  Aktion  ausfuhren  muB, 
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kann  der  Wert  in  „evnt_multi“  auch  verringert  werden.  Dann  tritt  das  Zeitereignis  ofter 
ein,  jedoch  stimmt  dieses  dann  nicht  mehr  mit  der  tatsachlich  verstrichenen  Zeit  iiberein. 


VOID  get_border  (WINDOW?  window,  WORD  obj,  RECT  *border); 

Der  UmriB  eines  Objekts  innerhalb  eines  Fensters  kann  bestimmt  werden.  Dies  funktio- 
niert  aber  nur,  wenn  ein  Objektbaum  in  die  Fensterstruktur  eingeklinkt  wurde. 

window:  Zeiger  auf  das  Fenster,  von  welchem  ein  Umrifi  bestimmt  werden  soil 
obj  : Index  des  Objekts 

border  : Zeiger  auf  das  Rechteck,  welches  den  UmriB  enthalt 

Falls  das  Fenster  nicht  existiert,  nicht  offen  ist,  kein  Objektbaum  existiert  oder  das  Objekt 
NIL  ist,  wird  der  UmriB  auf  null  gesetzt,  d.h.  X-  und  Y-Koordinate  sowie  Breite  und 
Hohe  sind  null.  Wird  dann  ein  „graf_growbox“  oder  ein  „graf_shrinkbox“  mit  diesem 
Rechteck  durchgefiihrt,  so  wird  cs  automatisch  von  der  Bildschirmmitte  gedffnet.  Dieser 
Effekt  ist  insofern  gunstig,  als  dann  ein  Objekt  zusammenschrumpfen  kann,  auch  wenn 
das  Vaterobjekt  oder  Fenster  nicht  mehr  existiert. 


VOID  draw_object  (WINDOW?  window,  WORD  obj); 

Ein  Objekt  in  einem  Fenster  wird  unter  Beriicksichtigung  der  Rechteckliste  gezeichnet. 
Dazu  muB  allerdings  ein  Objektbaum  iiber  die  Komponente  „object“  in  das  Fenster  einge- 
klinkt worden  sein. 

window:  Zeiger  auf  das  Fenster,  in  welchem  ein  Objekt  gezeichnet  werden  soil 
obj  : Index  des  Objekts 

VOID  drag.boxes  (WORD  num_objs,  CONST  RECT  *boxes, 

WINDOWP  inv.window,  SET  inv.objSj  RECT  *dlff, 

CONST  RECT  Abound); 


Es  kbnnen  mehrere  Rechtecke  gleichzeitig  verschoben  werden.  AuBerdem  kann  ein  Fen- 
ster angegeben  werden,  in  welchem  Objekte  invertiert  werden,  die  wahrend  des  Zieh- 
Vorgangs  iiberstrichen  werden. 


num_objs 

boxes 

inv_window 

inv_objs 


Anzahl  der  Objekte,  die  verschoben  werden 

Zeiger  auf  eine  Rechteckliste,  die  „num  objs“  Rechtecke  enthalt,  wel- 
che  die  zu  verschiebenden  Rechtecke  beschreiben 
Zeiger  auf  ein  Fenster,  in  welchem  Objekte  wahrend  des  Ziehens  inver- 
tiert werden 

Objekte,  welche  innerhalb  dieses  Fensters  selektiert  werden  diirfen 
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diff  : Zeiger  auf  ein  Rechteck,  welches  die  Differenz  der  verschobenen  Rccht- 

ecke  zum  Ausgangspunkt  angibt 

bound  : Zeiger  auf  ein  Rechteck,  in  welchem  sich  die  zu  verschiebenden  Recht- 

ecke  bewegen  durfen,  oder  NULL,  wenn  sich  diese  inncrhalb  des  gesam- 
ten  Desktops  bewegen  durfen 

Die  Funktion  simuliert  im  Prinzip  „graf_dragbox“  des  AES.  Allerdings  durfen  hier 
mehrere  Rechtecke  angegeben  werden.  AuBerdem  konnen  noch  Objekte  eines  Fensters 
invertiert  werden.  Das  Zeichnen  der  Rechtccke  ist  cine  nichltriviale  Aufgabe,  da  diese 
auf  jedem  Hintergrund  korrekt  aussehen  sollen.  Dies  gilt  vor  allem  fur  das  Muster  des 
Desktop.  Je  nach  Position  des  Rechtecks  und  dem  Zeichenalgorithmus  der  vier  Linien 
rniissen  andcre  Linienmuster  benutzt  werden.  Dieser  Algorithmus  funktioniert  zumindest 
fiir  alle  Rechner,  bei  denen  der  linke  obere  Eckpunkt  (0,  0)  beim  Desktop-Muster  nicht 
gesetzt  ist.  Falls  ein  Gratikprozessor  seine  Arbeit  verrichtet,  der  das  „Grau“  des  Desk- 
tops invertiert  darstellt  bzw.  andere  Algorithmen  benutzt,  uin  die  Linien  zu  zeichnen,  ist 
die  Routine  naturlich  nicht  mehr  ganz  korrekt.  Ein  Progranun,  das  z.B.  einen  unkorrekten 
Algorithmus  verwendet,  ist  das  Resourcc-Construction-Set  von  Kuma.  Bewegt  man  dort 
Piktogramme,  so  erscheinen  je  nach  deren  Position  abwechselnd  schwarze  und  weiBe 
Umrisse, 

Als  Ergebnis  wird  in  ,,diff.w“  und  „diff.h“  die  Differenz  der  Boxen  nach  dem  Ziehvor- 
gang  zuriickgegeben.  Daruberhinaus  ist  in  „diff.x“  und  ,,diff.y"‘  die  letzte  Mausposition 
gespeichert.  Beispiele  fiir  die.se  Funktion  finden  sich  in  den  Modulen  CLIPBRD  und 
DESKTOP. 


VOID  scroll  area  (CONST  RECT  *area,  WORD  dir,  WORD  delta); 

Ein  rechteckiger  Bildschirmbereich  wird  um  eine  beiiebige  Anzahl  von  Pixeln  in  eine  von 
vier  Richtungen  gescrollt.  Die  Maus  wird  automatisch  versteckt. 

area  : Zeiger  auf  das  Rechteck,  welches  gescrollt  werden  soil 
dir  : Richtung,  in  die  gescrollt  werden  soil,  namlich 
HORIZONTAL;  Links-Rechts-Scrolling 
VERTICAL  ; Aufwarts-Abwarts-Scrolling 
delta  : Anzahl  der  Pixel,  um  die  gescrollt  werden  soli,  wobei  gilt: 

Richtung  HORIZONTAL  und  delta  > 0 Links-Scrolling 

Richtung  HORIZONTAL  und  delta  < 0 Rcchts-Scrolling 

Richtung  VERTICAL  und  delta  > 0 Aufwarts-Scrolling 

Richtung  VERTICAL  und  delta  < 0 Abwarts-Scrolling 

Im  Gegensatz  zu  „scroll_window“  kann  hier  auch  ein  kleinerer  Bereich  gescrollt  wer- 
den, der  nicht  von  der  momentanen  FenstergrdBc  abhangig  ist.  Dadurch  kann  z.B.  cine 
einzelne  Zeile  eines  Texteditorfensters  um  einen  Buchstaben  gescrollt  werden,  wenn  in 
dieser  Zeile  ein  Zeichen  eingegeben  wird,  welches  nicht  das  letzte  Zeichen  einer  Zeile  ist. 


446 


6 Ein  universelles  Modulkonzepi  in  C 


VOID  clr  area  (CONST  RECT  *area); 

Ein  rechteckiger  Bildschirmbereich  wird  geloscht  (mit  weiB  gefullt). 
area;  Zeiger  auf  den  Bereich,  der  geloscht  werden  soil 

VOID  clr_work  (WINDOW?  window); 

Der  Arbeitsbereich  eines  Fensters  wird  geloscht  (mit  weiB  gefullt).  Hat  das  Fenster  eine 
Meniizeile,  so  wird  diese  nicht  geloscht. 

window:  Zeiger  auf  das  Fenster,  dessen  Arbeitsbereich  geloscht  werden  soli 
VOID  clr_scroll  (WINDOW?  window); 

Der  Scrollbereich  eines  Fensters  wird  geloscht  (mit  weiO  gefullt). 
window:  Zeiger  auf  das  Fenster,  dessen  Scrollbereich  geloscht  werden  soil 

VOID  clr_left  (WINDOW?  window); 

Der  linke  Rand  eines  Fensters  wird  geloscht  (mit  weiB  gefullt). 
window:  Zeiger  auf  das  Fenster,  dessen  linker  Rand  geloscht  werden  soil 

VOID  clr_top  (WINDOW?  window); 

Der  obere  Rand  eines  Fensters  wird  geloscht  (mit  weili  gefullt).  Hat  das  Fenster  eine 
Meniizeile,  so  wird  diese  nicht  geloscht. 

window:  Zeiger  auf  das  Fenster,  dessen  oberer  Rand  geloscht  werden  soil 
VOID  clr_right  (WINDOW?  window); 

Der  rechte  Rand  eines  Fensters  wird  geloscht  (mit  weiB  gefullt). 
window:  Zeiger  auf  das  Fenster,  dessen  rechter  Rand  geloscht  werden  soli 

VOID  clr  bottom  (WINDOW?  window); 

Der  untere  Rand  eines  Fensters  wird  geloscht  (mit  weiB  gefullt). 
window:  Zeiger  auf  das  Fenster,  dessen  unterer  Rand  geloscht  werden  soil 
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VOID  set_redraw  (WINDOW?  window,  CONST  RECT  *area); 

Einem  Fenster  wird  die  Meldung  gesendet,  da6  ein  Teil  seines  Bereichs  neu  gezeichnet 
werden  soil.  Dies  resulticrt  in  der  Nachricht  „WM_REDRAW“  an  den  Event- 
Manager. 

window:  Zeiger  auf  das  Fenster,  an  das  die  Meldung  gesendet  werden  soil 
area  : Zeiger  auf  den  Bereich,  der  neu  gezeichnet  werden  soil 


VOID  draw_mtitle  (WINDOW?  window,  WORD  title); 

Der  Mentititel  eines  offenen  Fensters,  welches  eine  Meniizeile  enthiilt,  wird  gezeichnet. 
Dabei  wird  die  Rechteckliste  des  Fensters  beriicksichtigt. 

window:  Zeiger  auf  das  Fenster,  dessen  Mentititel  gezeichnet  werden  soil 
title  : Index  des  Titels  im  Menubaum  des  Fensters 


n 

VOID  draw_mbar  (WINDOW?  window); 

Die  Menuzeile  eines  Fensters,  welches  eine  Mcnuzeile  enthalt,  wird  gezeichnet.  Dabei 
wird  die  Rechteckliste  des  Fensters  beriicksichtigt. 

window:  Zeiger  auf  das  Fenster,  dessen  Menuzeile  gezeichnet  werden  soli 


VOID  menu_.normal  (WINDOW?  window,  WORD  title,  BOOLEAN  normal); 

Der  Mentititel  eines  Fensters  oder  ein  globaler  Mentititel  werden  normal  Oder  invers  dar- 
gestellt.  Dies  entspricht  dem  Aufruf  „menu_tnormal“  der  AES-Menu-Bibliothek,  wo- 
bei  hier  noch  ein  Fenster  tibergeben  werden  kann. 

window : Zeiger  auf  das  Fenster,  dessen  Mentititel  gezeichnet  werden  soil,  oder  NULL, 
wenn  das  globale  Menti  benutzt  werden  soli 
title  : Index  des  Titels  im  Mentibaum  des  Fensters 

normal  : TRUE,  wenn  der  Titel  normal  dargestellt  werden  soil,  FALSE,  wenn  er  invers 
dargestellt  werden  soli 

Urn  zu  gewahrleistcn,  dal)  ein  Programm  auch  als  Accessory  ablauft,  sollte  nicht 
„menu_tnormal“  der  AES-Bibliothek,  sondem  „menu_normai“  des  Window-Mana- 
gers aufgerufen  werden  (siehe  Modul  MENU).  Dann  wird  bei  normalem  Betrieb  die  glo- 
bale Mentizeile  benutzt,  bei  Betrieb  als  Accessory  die  Meniizeile  im  Desktop-Fenster. 

BOOLEAN  menu.raanager  (WINDOWP  window,  WORD  mox,  WORD  moy, 

WORD  mobutton,  WORD  breturn) ; 
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Eine  komplette  Menii-Verwaltung  innerhalb  eines  Fensters  wird  durchgefiihrt.  Diese 
Routine  wird  vora  Event-Manager  (Modul  EVENT)  aufgerufen,  wenn  in  ein  Fenster  ge- 
klickt  wurde. 


menu_manager:  TRUE,  wenn  in  die  Menuzeile  oder  die  Pfeile  geklickt  wurde,  FALSE 
sonst 

window  : Zeiger  auf  das  Fenster,  in  dessen  Menuzeile  geklickt  wurde 

mox  : X-Position  der  Maus  beim  Anklicken 

moy  : Y-Position  der  Maus  beim  Anklicken 

mobutton  : Status  der  Knopfe  der  Maus  beim  Anklicken 

b return  : Anzahl  der  Klicks 


Bei  der  Bedienung  wird  immcr  der  linke  Mausknopf  benutzt.  Zunachst  wird  getestet,  ob 
sich  die  Mauskoordinaten  iiberhaupt  innerhalb  der  Menuzeile  befinden.  1st  dies  der  Fall, 
so  wird  gepriift,  ob  sich  die  Koordinaten  innerhalb  der  Pfeile  befinden.  Bei  positivem 
Test  werden  die  Pfeile  abgehandelt. 

Ein  Einfachklick  in  einen  der  Pfeile  bewegt  die  Menuzeile  in  die  entsprechende  (umge- 
kehrte)  Richtung,  ahnlich  wie  beim  normalen  Scrolling  eines  Fensters.  Bei  einem  Doppel- 
klick  wird  entweder  auf  das  erste  Menu  (linker  Pfeil)  oder  auf  das  letzte  Menu  (rechter 
Pfeil)  positioniert.  Diese  Operationen  wiederholen  sich  solange,  bis  die  Pfeile  verlassen 
werden. 


Wurde  nicht  in  einen  der  Pfeile  geklickt.  so  wird  zunachst  die  Funktion  „updt  menu“ 
der  Fensterstruktur  aufgerufen.  Dort  kann  die  Applikation  noch  schnell  Meniititel  oder 
Menueintrage  abschalten  (grau  darstellen). 

Nun  werden  die  Boxen,  in  denen  sich  die  Menueintrage  befinden,  an  die  aktuelle  Bild- 
schirmposition  angepaBt.  Es  wird  immer  versucht,  moglichst  viele  Menueintrage  zu  zei 
gen.  Fiir  die  horizontale  Richtung  gilt  daher:  Wurde  ein  Menii  rechts  aus  dem  Bildschirm 
herausklappen,  so  wird  versucht,  es  weiter  nach  links  herausklappen  zu  lassen.  Zunachst 
orientiert  sich  der  Menu-Manager  dabei  am  rechten  Rand  des  Meniititels.  1st  dieser  auch 
nicht  mehr  im  Bildschirm,  so  werden  die  Menueintrage  rechtsbiindig  zum  rechten  Rand 
des  Bildschirms  gezeichnet. 

Fiir  die  vertikale  Richtung  gilt:  Klappt  ein  Menii  unter  den  unteren  Rand  des  Bildschirms, 
so  klappt  es  genau  dann  nach  oben,  wenn  dadurch  mehr  Menueintrage  sichtbar  werden 
wiirden,  als  wenn  es  nach  unten  klappen  wiirde.  Ein  ahnlicher  Algorithmus  wird  auch 
bei  Windows  von  Microsoft  benutzt.  Reicht  der  Platz  dann  immer  noch  nicht,  so  wird 
eben  am  Bildschirmrand  abgeschnitten. 

Eventuelie  Rander,  Schatten  und  andere  Attribute  (z.B.  OUTLINED)  werden  komplett 
beriicksichtigt,  so  daB  die  Boxen  der  Menueintrage  auch  verschiedene  Attribute  haben 
konnen. 

Wird  auf  einen  grauen  Menutitel  geklickt,  so  klappt  das  Menii  nicht  herunter.  Das  erste 
Menii  in  einem  Fenster  kann  nur  einen  Eintrag  erhalten.  Die  Deskaccessories  werden 
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automatisch  abgetrennt,  da  auf  die  Dateinamen  der  Accessories  einerseits  nicht  zugegrif- 
fen  warden  kann,  andererseits  bei  spateren  GEM-Versionen  die  Accessory -Eintrage  nicht 
mehr  in  die  eigene  Meniizeile  eingetragen  warden.  Vielmehr  warden  diese  kopiert,  so 
daB  auf  die  Accessory-Eintrage  nicht  mehr  richtig  zugegriffen  werden  kann. 

Der  Menu-Manager  wird  beendet,  wenn  der  Mausknopf  losgelassen  bzw.  nochmals  ge- 
driickt  wird.  Dies  hangt  davon  ah,  wie  der  Menu-Manager  betreten  wurde.  Dabei  gilt 
das  gleiche  wie  fur  die  Pop-Up-Menus  (s.o.),  d.h.  es  gibt  eine  GEM-ahnliche  oder  eine 
Macintosh-ahnliche  Bedienung. 

Wurde  beim  Verlassen  auBerhalb  der  Menus  geklickt,  so  passiert  nichts.  Ansonsten  wird 
liber  die  Funktion  „hndl_menu“  der  Fensterstruktur  die  Routine  des  jeweiligen  Fen- 
sters  aufgerufen,  welche  fur  das  Abarbeiten  des  Mentis  zustandig  ist.  An  diese  werden 
dann  die  Parameter  „window“,  „title“  und  „item“  iibergeben,  d.h.  das  aktuelle  Fenster 
und  das  angewahlte  Menii  (item)  eines  Meniititels  (title). 


BOOLEAN  menu_key  (WINDOW?  window,  MKINFO  *mk); 

Fur  ein  Fenster  wird  getestet,  ob  eine  Taste  auf  ein  bestimmtes  Menii  zutrifft.  Ist  dies 

der  Fall,  so  wird  eine  entsprechende  Funktion  aufgerufen. 

menu  key:  TRUE,  wenn  das  Fenster  eine  Meniizeile  hat  und  eine  Taste  auf  ein  Menu 
zutrifft,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  welchem  ein  Menii  iiber  eine  Taste  aufgerufen 
werden  soli 

mk  : Zeiger  auf  die  Maus  und  Tastatur-Information  beim  Eintreten  des  Tastatur- 

ereignisses 

Fur  das  Desktop-Fenster  wird  das  globale  Menii  benutzt.  Fiir  das  Testen  der  Tastatur 

wird  die  globale  Funktion  „is_menu_key“  des  Moduls  GLOBAL  benutzt. 


BOOLEAN  init_windows  (WORD  err_nowindow,  WORD  max reswind); 

Das  Modul  WINDOWS  wird  initialisiert.  Dabei  wird  eine  Konstante  fiir  die  Fehlermel- 
dung  „Keine  weiteren  Fenster  mehr“  und  die  Anzahl  maximal  zu  erwartender  residenter 
Fenster  iibergeben. 

init_windows  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 
err  nowindow:  Index  der  Alertbox,  die  vom  Window-Manager  aufgerufen  werden  soil, 
wenn  keine  weiteren  Fenster  mehr  erzeugt  werden  konnen,  oder  NIL, 
wenn  keine  Meldung  erscheinen  soli 

max_reswind  : Maximale  Anzahl  der  zu  erwartenden  residenten  Fenster 
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Die  Initialisierung  lauft  schief,  wenn  nicht  mehr  geniigend  Speicher  zur  Verfugung  steht, 
um  genugend  Strukturen  des  Typs  WINDOW  zur  Verfugung  zu  stellen.  Die  Anzahl  der 
maximal  gleichzeitig  zur  Verfugung  stehenden  Strukturen  werden  in  „max_reswind“ 
ubergeben.  Eine  Struktur  bleibt  resident  im  Speicher,  wenn  ein  Fenster  beim  SchlieBen 

nicht  geloscht  wird.  Dies  ist  der  Fall,  wenn  das  Flag  „WI RESIDENT"  gesetzt  ist  und 

es  keine  Mdglichkeit  gibt,  das  Fenster  komplett  zu  loschen  (etwa  durch  eine  Piktogramm- 
Operation). 

Die  Anzahl  errechnet  sich  folgendemiaBcn;  Da  in  GEM  maximal  sieben  Fenster  der  glei- 
chen  Klasse  geoffnet  werden  konnen,  konnen  pro  Klasse,  bei  der  die  Fenster  resident  blei- 
ben,  auch  maximal  sieben  Strukturen  im  Speicher  stehen.  Von  den  Fenstern,  die  nicht 
resident  bleiben,  konnen  maximal  sieben  gleichzeitig  geoffnet  werden.  Da  beim  Schlie- 
Ben  auch  die  Datenstruktur  freigegeben  wird,  kann  sie  fiir  das  nachste  Fenster  genutzt 
werden.  Faustregel  ist  also 


7 * „Anzahl  der  residenten  Klassen"  + 7 

Ausnahmen  sind  Klassen,  bei  denen  nur  maximal  ein  Fenster  existieren  kann.  Dies  sind 
z.B.  der  Desktop  oder  das  Papierkorb-  bzw.  Klemmbrettfenster.  In  unserer  Beispielappli- 
kation  konnen  maximal  24  Fenster  existieren  (maximal  sieben  davon  offen  bzw,  acht  bei 
Beriicksichtigung  des  Desktops): 

1 Desktop-Fenster 
1 Papierkorb-Fenster 
1 Klemmbrett-Fenster 
7 Grafik-Fenster 

7 Fenster  mit  mathematischen  Potenzen 

Das  sind  siebzehn  Fenster,  die  resident  im  Speicher  gehalten  werden.  Dazu  kommen  ma- 
ximal sieben  weitere  Fenster,  die  nicht  resident  sind,  und  deswegen  nur  in  geoffnetem 
Zustand  existieren: 

7 Meta-Datei-Fenster  oder 
7 Bit-Image-Datei-Fenster  oder 
7 Text-Fenster 

Letztere  drei  Klassen  sind  nicht  resident,  so  daB  eine  beliebige  Kombination  von  ihnen 
(zusammen  maximal  sieben)  gleichzeitig  offen  sein  kann. 

Die  Anzahl  der  Fenster  hatte  auch  dynamisch  ermittelt  werden  konnen,  indem  bei  jedem 
Offnen  eines  Fensters  fiir  eine  Fensterstruktur  Speicherplatz  reserviert  werden  wiirde. 
Fur  ein  Accessory  kann  dies  aber  bdse  Folgen  haben,  da  beim  Beenden  einer  Applikation 
auch  der  Speicherplatz  des  Accessories  freigegeben  wird,  der  zum  Zeitpunkt  des  Ablaufs 
der  Applikation  angefordert  wurde. 
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BOOLEAN  term_windows  (VOID); 

Das  Modul  WINDOWS  wird  tcrminiert.  Es  werden  alle  Fenster  geschlossen  und  die 
Datenstrukturen  fur  die  Fenster  freigegeben. 

term_windows:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.4  Modul  RCM 

Das  Resource-Create-Modul  wurde  schon  im  Kapitel  2 besprochen.  Seine  Erwahnung 
dient  hier  nur  der  Vollstandigkeit  halber. 


6.5.5  Modul  EVENT 

Bin  GEM-Programm  wird  iiblicherweise  durch  eine  Ereignisverwaltung  bestimmt.  Der 
Benutzer  agiert  dabei  mit  Hilfe  der  Mans  oder  der  Tastatur,  urn  dem  Rechner  bestimmte 
Befehle  zu  geben.  An  einer  zentralen  Stelle  wird  auf  alle  mdglichen  auftretenden  Ereig- 
nisse  gewartet.  Tritt  ein  Ereignis  ein,  auf  das  die  Applikation  gewartet  hat,  so  reagiert 
diese  darauf. 

In  den  meisten  GEM-Programmen  lauft  diese  Ereignisabfrage  ^nlich  ab.  Uber  einen 
Aufruf  der  Event-Library  wird  mit  Hilfe  der  Funktion  „evnt_multi“  Oder 
„evnt_event“  (X/GEM)  auf  alle  mdglichen  Ereignisse  gewartet.  Nach  Auftreten  des 
Ereignisses  verzweigt  das  Programm  in  verschiedene  Stellen,  um  die  Ereignisse  abzuar- 
beiten.  Ereignisse  kdnnen  sein;  Tastaturercignisse,  Mausknopfereignisse,  Mausbewe- 
gungsereignisse  filr  verschiedene  Mausformen,  Nachrichtenereignisse  (Menus,  Fenster- 
nachrichten)  und  Zeitereignisse  fur  Multitasking. 

Der  Event-Manager  ist  praktisch  unabhangig  von  der  Applikation  konzipiert  worden,  so 
dal)  er  fiir  alle  Applikationen  oder  Accessories  benutzt  werden  kann. 


a)  Globale  Variablen 
GLOBAL  WORD  bmask; 

Die  Maske  fur  die  Mauskndpfe  gibt  an,  auf  welche  Mauskdpfe  gewartet  werden  soil , Das 
niederwertigste  Bit  bezeichnet  den  am  weitesten  links  stehenden  Mausknopf.  Die  Varia- 
ble wird  in  der  Initialisierungsroutine  des  Moduls  auf  1 initialisiert,  d.h.  cs  wird  auf  den 
linken  Mausknopf  gewartet.  Leider  ist  es  in  GEM  standardmabig  nicht  mdglich,  zusatz- 
lich  auf  den  rechten  Mauskopf  zu  warten.  also  „bmask“  auf  3 zu  setzen.  GEM  wiirde 
dann  auf  das  gleichzeitige  Driicken  des  linken  und  rechten  Mausknopfes  warten.  Erst  in 
X/GEM  ist  dieser  Fehler  behoben. 
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GLOBAL  WORD  bstate; 

Der  Status  fur  die  Mausknopfe  gibt  an,  ob  auf  das  Driicken  Oder  das  Loslassen  eines 
Mausknopfes  gewartet  werden  soil.  Dabei  bedeutet  ein  gesetztes  Bit,  daC  auf  das  Driicken 
gewartet  werden  soli.  Das  niederwertigste  Bit  bezeichnet  den  am  weitesten  links  stehen- 
den  Mausknopf.  Die  Variable  wird  in  der  Initialisierungsroutine  des  Moduls  auf  1 initiali- 
siert,  d.h.  es  wird  auf  das  Driicken  des  linken  Mausknopfes  gewartet. 

Normalerweise  werden  die  Bits  dieser  Variablen  jeweils  umgeschaltet,  so  daB  nach  dem 
Warten  auf  das  Driicken  eines  Mausknopfes  auf  dessen  Loslassen  gewartet  wird  und  um- 
gekehrt.  Es  kann  allerdings  auch  sinnvoll  sein,  stiindig  auf  das  Driicken  der  Kndpfe  zu 
warten.  Dies  ist  etwa  der  Fall,  wenn  auf  eine  Funktionstaste  geklickt  wurde.  In  diesem 
Fall  wird  nochmals  auf  das  Driicken  der  Kndpfe  gewartet,  damit  beim  durchgehenden 
Driicken  des  Mausknopfes  standig  Mausknopfereignisse  auftreten.  Ein  Beispiel  hierfiir 
wird  im  Modul  DESKTOP  gegeben. 


b)  Globale  Funktionen 
VOID  hndUevents  (VOID); 

Diese  Funktion  handhabt  alle  Ereignisse,  die  in  GEM  auftreten  kdnnen.  Sie  wird  vom 
Hauptprogramm  aufgerufen  und  terminiert  genau  dann,  wenn  das  Programm  verlassen 
werden  soli.  Bei  einem  Accessory  wird  diese  Funktion  niemals  beendet. 

Vor  dem  Warten  auf  die  entsprechenden  Ereignisse  wird  festgestellt,  ob  ein  Fenster  die- 
ses Prozesses  eine  eigene  Mausform  hat  und  oben  liegt.  Ist  dies  der  Fall,  so  wird  auf  den 
Eintritt  in  oder  den  Austritt  aus  dem  Scrollbereich  des  Fensters  gewartet.  Hat  das  oberste 
Fenster  durch  Eintreten  irgendeines  Ereignisses  gewechselt,  so  wird  auf  jeden  FaU  auf 
den  Eintritt  in  den  Bereich  gewartet. 

Die  Funktion  wartet  in  einer  Schleife  mittels  „evnt_multi“  auf  alle  eintretenden  GEM- 
Ereignisse.  Fiir  jedes  Ereignis  wird  eine  entsprechende  Routine  aufgerufen,  die  jeweils 
lokal  zu  diesem  Modul  definiert  ist. 

Fur  die  X/GEM-Version  wird  bei  jedem  Schleifendurchlauf  festgestellt,  ob  sich  noch  ein 
offenes  Fenster  in  diesem  ProzeB  befindet.  Ist  dies  nicht  der  Fall,  so  wird  die  Applikation 
beendet,  da  die  Meniizeile  nach  dem  SchlieBen  des  letzten  Fensters  nicht  mehr  zugangiich 
ist. 

AuBerdem  wird  die  Funktion  „updt  menu“  aufgerufen,  die  pruft,  ob  sich  durch  ein 
Ereignis  irgendein  Menii  verandert  hat,  also  z.B.  abgeschaltet  werden  muB  (siehe  auch 
Modul  MENU). 


c)  lokale  Funktionen 

VOID  hndl  keybd  (MKINFO  *mk); 

Das  Ereignis  „Driicken  einer  Taste“  wird  abgearbeitet. 
mk:  Zeiger  auf  die  Maus-  und  Tastaturinformation 


453 


6.5  Modulbeschreibung 


Beim  Auftreten  eines  Tastaturereignisses  wird  alien  Fenstern  (von  oben  nach  unten)  die 
Information  iiber  einen  Aufruf  von  „key_aH“  des  Moduls  WINDOWS  angeboten.  Zu- 
satzlich  wird  gepriift,  ob  eine  Meniizeile  existiert,  das  Desktop-Fenster  aber  nicht  vorhan- 
den  Oder  geschlossen  ist.  In  diesem  Fall  kann  die  Taste  nicht  iiber  das  Desktopfenster 
in  der  Routine  „key_all“  erreicht  werden.  Die  Funktion  „is_menu_key“  mu6  dann 
mit  dem  globalen  Menii  aufgerufen  werden,  um  auf  die  Taste  zu  reagieren. 


VOID  hndl_button  (MKINFO  *mk); 

Das  Ereignis  „Mausknopf  gedriickt  oder  losgelassen"  wird  abgearbeitet. 
mk:  Zeiger  auf  die  Maus-  und  Tastaturinformation 

Wurde  auf  das  Loslassen  eines  Knopfes  gewartet,  so  wird  umgeschaltet,  so  da6  das  nach- 
ste  Mausknopf-Ereignis  das  Drucken  eines  Knopfes  ist. 

Ansonsten  wird  das  Fenster  gesucht,  in  welches  geklickt  wurde.  Handelt  es  sich  um  ein 
Fenster  dieses  Prozesses,  so  wird  zunachst  gepriift,  ob  sich  eine  Meniizeile  in  ihm  befin- 
det.  In  diesem  Falle  wird  zum  Menu-Manager  verzweigt  und,  falls  in  die  Meniizeile  ge- 
klickt wurde,  werden  entsprechende  Routinen  ausgefiihrt  und  danach  die  Klick- 
Behandlung  abgebrochen. 

Hat  ein  Fenster  keine  Menuzeile  oder  wurde  nicht  in  die  Meniizeile  geklickt,  so  wird  iiber 
„click_window“  des  Window-Managers  das  Fenster  angeklickt. 

Wurde  kein  Fenster  gefunden,  so  wurde  eventuell  auf  den  leeren  Desktop  geklickt,  falls 
die  Applikation  keinen  Desktop  angemeldet  hat.  In  diesem  Falle  wird  das  zuletzt  selek- 
tierte  Fenster  deselektiert.  Dies  funktioniert  nur  bei  der  alten  Atari  GEM-Version.  Bei 
neueren  Versionen  erhalt  die  Applikation  kein  Ereignis,  wenn  in  den  nicht  angemeldeten 
Desktop  geklickt  wurde. 


VOID  hndl  ml  (WINDOW?  top,  DWORD  *mlflags); 

Das  Ereignis  „Maus  ist  in  Fenster  eingetretcn  oder  hat  dieses  verlassen"  wird  abge- 
arbeitet. 

top  : Zeiger  auf  das  oberste  Fenster 

mlflags:  Zeiger  auf  die  Flags  fiir  das  Eintreten  in  das  Rechteck  oder  Verlassen  des 
Rechtecks 

Dieses  Mausereignis  wird  fiir  den  Cursor  benutzt,  der  sich  im  Scrollbereich  eines  Fen- 
sters  andern  darf.  Wenn  „mlflags“  gesetzt  ist,  so  hat  die  Maus  den  Bereich  verlassen 
und  wird  auf  einen  Pfeil  gesetzt-  Ansonsten  wird  sie  auf  die  Mausform  gesetzt,  die  in 
der  Fensterstruktur  gesetzt  ist,  falls  es  ein  solches  Fenster  gibt  (top  ! = NULL). 
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Danach  werden  die  „mlflags“  invertiert,  um  auf  das  gegenteilige  Ereignis  zu  warten 
(Eintritt  Oder  Austritt). 


VOID  hndl__mesag  (WORD  *msgbuff); 

Das  Ereignis  „Nachricht  eingetroffen"  wird  abgearbeitet. 

msgbuff:  Zeiger  auf  ein  Feld  mit  acht  WORD-Werten,  welches  die  Nachricht  spezifi- 
ziert.  Die  Nachrichten  warden  in  Kapitel  2 beschrieben. 

Im  wesentlichen  wird  entweder  die  Meniibehandlung  aufgerufen  (hndl_menu)  Oder  eine 
entsprechende  Funktion  des  Window-Managers. 

Wird  das  Offnen  eines  Accessories  verlangt,  so  wird  der  Desktop  geoffnet.  Der  Desktop 
selbst  erscheint  in  einem  Fenster.  Statt  des  Desktops  kann  auch  jedes  andere  Fenster  oder 
eine  Dialogbox  geoffnet  werden. 

Beim  SchlieBen  eines  Accessories  werden  alle  zu  diesem  ProzeB  gehorenden  Fenster  ge- 
schlossen. 


VOID  hndl —timer  (LONG  millisecs); 

Das  Ereignis  „Zeitspanne  abgelaufen"  wird  abgearbeitet. 

millisecs:  Anzahl  der  Millisekunden,  die  seit  dem  letzten  Zeitereignis  verstrichen  sind. 

Die  Funktion  ruft  „timer  all“  des  Window-Managers  auf,  um  alien  Fenstern  die  Mog- 
lichkeit  zu  geben,  auf  das  Zeitereignis  zu  reagieren.  Jc  nach  Fenster  konnen  unterschied- 
liche  Dinge  passieren,  so  daB  eine  Art  Multitasking  implementiert  werden  kann. 


6.5.6  Modul  INITERM 

Das  Modul  hat  die  Aufgabe,  alle  anderen  Module  (auBer  GEMAIN)  zu  initialisieren  und 
zu  terminieren.  Dazu  stellt  es  zwei  Funktionen  zur  Verfugung. 

BOOLEAN  init_initerm  (INT  argc,  BYTE  *argv  []); 

Alle  Module  werden  initialisiert. 

init_initerm:  TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 
argc  ; „argc“  aus  der  Parameterliste  von  „main“ 

argv  : „argv“  aus  der  Parameterliste  von  „main“ 
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In  dieser  Funktion  werden  alle  Module  auBer  GEMAIN  einmal  aufgerufen  und  damit  ini- 
tialisiert.  Die  Reihenfolge  der  Initialisierung  ist  wichtig.  Zuerst  muB  das  Modul  GLO- 
BAL initialisiert  werden,  da  dort  das  Anmelden  beim  GEM  geschieht,  Wenn  dies  nicht 
gelingt,  wird  sofort  abgebrochen.  Hier  werden  „argc“  und  „argv“  benutzt  sowie  das  Me- 
nu fur  das  Accessory  und  die  Klasse  fiir  den  Desktop  angegeben. 

Dann  folgen  die  Resourcen.  Klappt  die  Initialisierung  nicht,  wird  ebenfalls  sofort  abge- 
brochen. 

Nun  muB  der  Window-Manager  initialisiert  werden.  An  ihn  wird  der  Index  fiir  die  Fehler- 
meldung  ubergeben,  die  aufgerufen  wird,  wenn  kein  Fenster  mehr  kreiert  werden  kann. 
AuBerdem  wird  die  Anzahl  der  zu  erwartenden  residenten  Fenster  ubergeben  (siehe 
„init_windows“). 

Nun  folgt  die  Initialisierung  der  anderen  Module.  Ihre  Reihenfolge  spielt  keine  groBe 
Rolle  mehr. 

Nach  dem  Initialisieren  wird  die  virtuelle  Workstation  geoffnet.  Falls  es  sich  nicht  urn 
ein  Deskaccessory  handed,  wird  auBerdem  die  Meniizeile  gezeichnet,  falls  eine  solche 
existiert.  Danach  wird  zuniichst  der  Desktop,  dann  noch  das  Klemmbrettfenster  geoffnet. 

Falls  die  Kommandozeile  (tail)  nicht  leer  ist,  werden  noch  Fenster  fur  alle  Dateien  geoff- 
net, Handed  es  sich  urn  Bit-Image-  Oder  Metadateien,  dann  werden  diese  angezeigt.  Alle 
anderen  Typen  werden  als  Textdateien  angezeigt. 


BOOLEAN  term_initerm  (VOID); 

Alle  Module  werden  terminiert. 

term_initerm:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 

Beim  Terminieren  wird  festgestellt,  ob  die  Applikation  von  einer  anderen  Applikation 
aufgerufen  wurde,  die  dies  durch  Anhangen  des  Programmnamens  an  die  Parameter 
kundgetan  hat  (siehe  auch  Kapitel  5). 

Ist  dies  der  Fall,  so  wird  uber  einen  „shel  write“-Befehl  dieses  Programm  aufgerufen. 
Dabei  wird  angenommen,  daB  es  sich  urn  eine  Grafik-Applikation  handelt.  Neben  den 
Parametern,  die  vom  Aufrufer  gekommen  sind,  wird  der  eigene  Programmname  ange- 
hangt.  Bei  X/GEM-Applikationen  ist  der  gesamte  Vorgang  nicht  notig,  da  die  aufrufende 
Applikation  zu  diesem  Zeitpunkt  noch  aktiv  ist  bzw.  aktiv  sein  kann.  Ein  erneuter  Aufruf 
wiirde  nur  eine  neue  Inkarnation  der  aufrufenden  Applikation  zur  Folge  haben. 

Nun  wird  die  Meniizeile  freigegeben.  Danach  folgen  die  Terminierungsroutinen  aller 
Module,  die  oben  initialisiert  warden  sind.  Dies  geschieht  in  umgekehrter  Reihenfolge. 
Am  Ende  wird  das  Modul  GLOBAL  terminiert. 
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6.5.7  Modul  RESOURCE 

Das  Modul  stellt  die  Funktionen  zur  Initialisierung  der  Resourcen  zur  Verfiigung.  Dazu 
gehdrt  das  Laden  der  Resource-Datei,  wenn  vorhanden,  sowie  das  Einrichten  von  be- 
stimmten  benutzerdefinierten  Objekten.  Aufierdem  werden  die  Piktogramme  und  Bit- 
Images  vom  Standardformat  in  das  geratespezifische  Format  transformiert. 


a)  Globale  Variablen 

GLOBAL  OBJECT  *infmeta; 

GLOBAL  OBJECT  *popup; 

GLOBAL  OBJECT  *userimg; 

GLOBAL  OBJECT  *icons; 

GLOBAL  OBJECT  *settings; 

GLOBAL  OBJECT  *sethelp; 

GLOBAL  OBJECT  *cHpmenu; 

Es  handelt  sich  hierbei  urn  alle  Objektbaume,  die  nicht  im  Modul  GLOBAL  definiert  sind. 
Alle  Module,  die  Objektbaume  benutzen,  miissen  RESOURCE. H einbinden. 


b)  Globale  Funktionen 
BOOLEAN  init_resource  (VOID); 

Das  Modul  wird  initialisiert. 

Wenn  das  Makro  RSC_CREATE  auf  eins  gesetzt  ist,  so  werden  die  Resourcen  iiber  die 
Funktion  „rsc_create“  initialisiert.  Dabei  muB  die  Textdatei  SCRAP.RSH  eingebunden 
werden.  Sie  wird  erzeugt,  indem  im  Programm  RCS.  APP  von  Digital  Research  im  Menu 
„Global“  der  Menupunkt  „Output...“  angewahk  und  „Source  file  for  resource"  ange- 
klickt  wird.  Beim  Speichern  der  Resource-Datei  wird  dann  SCRAP.RSH  erzeugt. 

Ist  das  Macro  nicht  gesetzt,  so  wird  die  Resource-Datei  geladen . Fiir  das  alte  GEM  wird 
dazu  der  Name  der  Resource-Datei  bendtigt.  Er  wird  in  einem  Makro  angegeben.  In  je- 
dem  anderen  Fall  wird  dieser  aus  dem  Namen  der  Applikation  durch  Konkatenieren  des 
Suffix  „RSC“  erzeugt.  Beim  Atari  kdnnte  der  Fall  eintreten,  daB  der  Name  der  Applika- 
tion nicht  richtig  gesetzt  wird,  wenn  eine  Shell  benutzt  wird,  die  nicht  „shel_write“  be- 
nutzt,  sondern  „Pexec".  Dann  wurde  auch  die  Resource-Datei  nicht  richtig  geladen  wer- 
den kdnnen,  wenn  sich  ihr  Name  aus  dem  Namen  der  Applikation  ableitet. 

Wird  die  Resource-Datei  nicht  gefunden,  so  wird  eine  Warnung  ausgegeben.  Dies  ist  die 
einzige  Warnung,  die  sich  nicht  in  einer  Resource-Datei  befmden  kann.  Aus  diesem 
Grund  ist  sie  nicht  in  einer  speziellen  Sprache  verfaBt. 
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Da  Accessories  bei  nicht  vorhandener  Resource-Datei  nicht  existieren  sollten,  wird  das 
Accessory-Menu  abgemeldet  und  endlos  auf  das  Verstreichen  einer  bestirnmten  Zeit  ge- 
wartet  (jeweils  ungefahr  65s).  Damit  kommen  auch  die  anderen  Prozesse  zum  Zug.  Aus 
diesem  Grund  sollten  Accessories  keine  Resource-Datei  einladen,  sondern 
RSC  CREATE  benutzen. 

Nun  werden  die  Resource-Adressen  der  Fehlermeldungen  und  Baume  geholt.  Danach 
wird  eine  virtuelle  Workstation  geoffnet,  da  damit  das  „vdi_handle“  gtiltig  ist  und  die 
Anzahl  der  Farben  bestimmt  wird.  Das  „vdi_handle“  wird  fiir  das  Trans formieren  der 
Piktogramme  bendtigt. 

Fiir  jeden  Objektbaum  wird  die  Routine  „fix_objs“  aufgerufen,  die  in  diesem  Modul 
lokal  definiert  ist  und  eine  zentrale  Funktion  ausubt. 

Zuniichst  wird  jede  Dialogbox  in  den  OUTLINED-Status  gesetzt.  Die  GEM-Funktion 
„rsrc_load“  setzt  seit  den  neueren  GEM-Versionen  die  Boxen  immer  auf  SHADO- 
WED, auch  wenn  sie  als  OUTLINED  definiert  wurden. 


Alle  Objekte  jedes  Baumes  werden  nun  durchgegangen.  Falls  es  sich  urn  eine  Menuzeile 
handelt,  werden  fiir  die  neueren  GEM-Versionen  die  unansehbaren  Trennzeichen,  die 
sich  aus  dem  Zeichen  ASCII  19  ergeben,  durch  normale  Bindestriche  ersetzt.  Jene  Zei- 
chen  werden  von  neueren  Resource-Construction-Sets  benutzt.  Sie  sind  aber  nicht  sym- 
metrisch  und  sehen  klobig  aus,  Wahrscheinlich  muBte  Digital  Research  diese  andern,  well 
sie  zu  sehr  nach  den  Macintosh-Trennzeichen  ausgesehen  haben. 

Handelt  es  sich  um  Piktogramme,  so  werden  diese  transformiert.  Zusatzlich  wird  der 
Rahmen,  der  sich  um  die  Piktogramme  legt,  also  die  Objekthohe,  aus  den  Werten  des 
Piktogrammes  errechnet.  Damit  kommt  es  nicht  mehr  zu  unerwiinschten  falschen  Objekt- 
hdhen  bei  niedriger  Auflosung.  Sie  haben  sich  dadurch  bemerkbar  gemacht,  da6  die  Ob- 
jekthdhe  kleiner  als  die  Piktogrammhohe  war. 


Wird  ein  erweiterter  Typ  gefunden,  so  werden  die  notigen  Initialisierungen  fiir  die  benut- 
zerdefmierten  Objekte  gemacht.  Durch  die  Benutzung  verschiedener  Auflosungen  ist  es 
eine  nicht  gerade  triviale  Aufgabe,  die  ankreuzbaren  Boxen  quadratisch  und  die  Radio- 
Buttons  rund  zu  halten.  Dabei  wird  mehr  MaB  auf  Asthetik  beim  Algorithmus  des  Linien- 
zeichnens  gelegt  (regelmallige  Treppen),  als  auf  das  exakte  Verhaltnis  der  Rechteck- 
seiten. 

Ist  ein  Desktop  in  der  Resource-Datei  vorhanden,  so  werden  verschiedene  Initialisierun- 
gen durchgefiihrt.  Die  Infozeile  des  Desktop  wird  versteckt  und  auf  leer  gesetzt.  Ist  die 
Breite  des  Bildschirms  kleiner  als  die  Breite  des  Desktops  (z.B.  640  Pixel),  so  wird  der 
Desktop  in  ein  Fenster  gelegt.  Dazu  wird  die  Klasse  des  Desktops  in  „DESKWINDOW“ 
umgewandelt.  Fiir  den  Atari  ST  wird  der  Desktop  in  mittlerer  Auflosung  in  Griin  darge- 
stellt,  wie  dies  iiblich  ist.  Ansonsten  wird  er  in  Blau  dargestellt. 
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Nun  wird  die  Objektbreite  des  Desktop-Baums  angepaBt,  falls  der  Bildschirm  groBer  ist. 
Dadurch  ist  das  Programm  auch  auf  einem  GroBbildschirm  lauffahig.  SchlieBlich  werden 
die  Funktionstasten  und  Piktogramme  entsprechend  plaziert. 


BOOLEAN  terin_resource  (VOID); 

Das  Modul  wird  terminiert.  Beim  Terminieren  werden  die  Resourcen  freigegeben. 
term_resource:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 

6.5.8  Modul  MENU 

Das  Modul  behandelt  die  MenQverwaltung  fur  die  globale  Meniizeile.  Falls  es  sich  bei 
der  Applikation  um  ein  Accessory  handelt,  bietet  das  Mcxlul  auch  die  Behandlung  der 
Meniizeile  im  Fenster  des  Accessories. 

a)  Globale  Vartablen 
GLOBAL  BOOLEAN  menu_ok; 

Die  Variable  ist  TRUE,  wenn  der  MenUbaum  nicht  NULL,  also  vorhanden  ist,  FALSE 
sonst. 


GLOBAL  BOOLEAN  menu_fits; 

Die  Variable  ist  TRUE,  wenn  die  Meniizeile  vorhanden  ist  und  auf  den  Desktop  paBt, 
FALSE  sonst.  Bei  niedriger  Auflosung  ist  die  Variable  also  FALSE,  wenn  die  Meniizeile 
mehr  als  40  Zeichen  umfaBt. 


GLOBAL  FUNCINFO  funcmenus  [MAX_FUNC]; 

Der  Typ  FUNCINFO  besteht  aus  den  Komponenten  „title“  und  „item“.  Fur  jede  Funk- 
tionstaste  wird  in  dieser  Variablen  abgelegt,  welcher  Menutitel  und  welcher  Meniieintrag 
bei  Betatigen  der  Funktionstaste  ausgelost  wird.  Dieses  Feld  wird  nur  benotigt,  wenn 
Funktionstasten  auch  auf  dem  Desktop  sichtbar  sind.  Ansonsten  geniigt  es,  die  Funktiona- 
litat  in  den  Menueintragen  festzulegen  (siehe  auch  Kapitel  5). 


GLOBAL  SET  menus; 

Diese  Menge  gibt  die  Nummern  der  Meniis  an,  die  gerade  aktiv  sind. 


b)  Globale  Funktionen 

VOID  updt_menu  (WINDOW?  window); 
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Die  Menueintrage  werden  auf  den  neuesten  Stand  gebracht,  d.h.  sie  werden  ein-  oder 
ausgeschaltet  (enabled  oder  disabled).  Die  Funktion  wird  nach  jedem  Ereignis  aus  dem 
Modul  EVENT  aufgerufen. 

window:  Zeiger  auf  das  Fenster,  in  welchem  sich  die  Meniizeile  befindet  oder  NULL, 
wenn  es  sich  um  die  globale  GEM-Menuzeile  handelt 

Da  die  Meniizeile  auch  in  einem  Fenster  liegen  kann,  muB  der  Parameter  „window“  mit 
angegeben  werden.  Die  Funktion  kann  namlich  auch  vom  Window-Manager  aufgerufen 
werden,  der  immer  als  Parameter  das  Fenster  iibergibt. 

Die  einzelnen  Menueintrage  werden  abhangig  vom  Zustand  der  Applikation  ein-  oder 
ausgeschaltet.  Falls  Funktionstasten  auf  dem  Desktop  sichtbar  sind,  so  werden  diese  an 
die  neue  Situation  angepaBt,  Nur  wenn  sich  etwas  geandert  hat,  werden  diese  neu  ge- 
zeichnet. 


VOID  hndl  menu  (WINDOWP  window,  WORD  title,  WORD  item); 

Die  Funktion  ubernimmt  die  Abarbeitung  der  globalen  Meniizeile  bzw.  der  Meniizeile 
des  Desktops,  falls  dieser  in  einem  Fenster  liegt. 

window:  Zeiger  auf  das  Fenster,  in  welchem  sich  die  Menuzeile  befindet  oder  NULL, 
wenn  es  sich  um  die  globale  GEM-Meniizeile  handelt 
title  : Titel  des  ausgewahiten  Meniis 
item  : Eintrag  des  ausgewahiten  Meniis 

Da  die  Menuzeile  auch  in  einem  Fenster  liegen  kann,  muB  der  Parameter  „window“  mit 
angegeben  werden.  Bei  einem  Ereignis  „Menii  ausgewahlt",  welches  von  GEM  geliefert 
wird,  muB  als  Parameter  „window“  = NULL  iibergeben  werden. 

Je  nach  Meniititel  und  Meniieintrag  wird  zu  einer  entsprechenden  Funktion  verzweigt. 
Da  die  meisten  Meniis  allerdings  allgemeingiiltig  sind,  muB  keine  spezielle  Funktion  auf- 
gerufen werden. 

Falls  das  Menti  „Uber...“  aufgerufen  wird,  wird  zur  Funktion  „mabout“  verzweigt,  fiir 
das  Menii  „ Einstell ungen.. .“  zur  Funktion  „msettings“.  Die  beiden  Funktionen  sind  in 
diesem  Modul  defmiert. 


BOOLEAN  init_menu  (VOID); 

Das  Modul  wird  initialisiert. 

init_menu:  TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 

Beim  Initialisieren  werden  zunachst  die  Meniis  der  Funktionstasten  der  Variablen  „func- 
menus"  zugewiesen. 
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Daraufhin  wird  festgestellt,  ob  die  Meniizeile  auf  den  Bildschirm  paBt.  1st  dies  nicht  der 
Fall,  so  wird  die  Klasse  des  Desktops  auf  DESKWINDOW  gesetzt,  so  daB  die  Meniizeile 
nun  in  einem  Fenster  erscheint. 

1st  die  Meniizeile  vorhanden,  so  wird  der  Name  des  Aufrufers  in  den  vorletzten  Eintrag 
des  Mentis  „Datei“  eingesetzt.  Dies  ist  fur  Programme  wie  z.B.  OUTPUT  notwendig, 
damit  diese  ihren  Aufrufer  wieder  starten  kdnnen,  Falls  kein  Aufrufer  existiert,  wird  der 
Menileintrag  (MCALLER)  geloscht. 

Wenn  die  Meniizeile  normal  auf  dem  Bildschirm  erscheint,  so  wird  getestet,  ob  ein  Drop- 
Down-Menii  aus  dem  rechten  Rand  des  Bildschirms  herausklappt.  Falls  dies  der  Fall  ist, 
wird  das  Menii  entsprechend  korrigiert.  Man  muB  sich  also  keine  Gedanken  mehr  iiber 
die  Breite  seiner  Meniis  machen. 


BOOLEAN  term_„menu  (VOID); 

Das  Modul  wird  terminiert. 

term„menu;  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.9  Modui  DESKTOP 

Das  Modul  zeigt  ein  Beispiel  fur  einen  eigenen  Desktop  mit  einigen  Piktogrammen.  Er 
wurde  ahnlich  angelegt  wie  der  GEM-Desktop.  Allerdings  befinden  sich  in  ihm  noch 
Funktionstasten.  Der  Desktop  wird  bei  X/GEM  in  ein  Fenster  gelegt,  bei  anderen  Versio- 
nen  ersetzt  er  den  von  GEM  bekannten  „grau  gemusterten  Desktop'*. 


WINDOW?  find_desk  (VOID); 

Die  Funktion  liefert  einen  Zeiger  auf  die  Beschreibung  des  Desktop-Fensters. 

find_desk:  Zeiger  auf  das  Fenster,  das  den  Desktop  beschreibt,  Oder  NULL,  wenn 
kein 

Desktop  existiert. 


VOID  get_dxywh  (WORD  obj,  RECT  *border); 

Das  Rechteck,  das  ein  Objekt  im  Desktop  gerade  einschlieBt  (z.B.  eines  Piktogramms) 
kann  im  Desktop  ermittelt  werden. 

obj  : Index  des  Objekts 
border  : Umrandung  des  Objekts 


6.5  Modulbesckreibung 
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1st  das  Desktop-Fenster  nicht  vorhanden  Oder  geschlossen,  kein  Objektbaum  in  ihn  einge- 
klinkt  Oder  „obj“  NIL,  so  wird  ein  Rechteck  ohne  Breite  und  Hohe  (jeweils  null)  zuriick- 
gegeben.  Die  Koordinaten  sind  dann  ebenfalls  null. 


VOID  set_func  (CONST  BYTE  *keys); 

Die  Funktionstasten  des  Desktops  konnen  beschriftet  werden.  Sie  werden  nicht  sofort  ge- 
zeichnet.  Dies  mufl  mit  „draw_func“  oder  „draw_.key“  (s.u.)  erledigt  werden. 

keys:  Zeiger  auf  die  Zeichenkette,  welche  die  Funktionstasten  beschreibt 

Die  Texte  der  einzelnen  Funktionstasten  werden  durch  Kommata  getrennt.  Sollen  be- 
stimmte  Funktionstasten  erhalten  bleiben,  so  kann  statt  des  Eintrags  auch  ein  $-Zeichen 
auftreten.  So  werden  z.B.  durch  die  Zeichenkette 

„6ffnen,Schlielien,$,$,$,$,Ausschneiden,Kopieren,Einfugen,Ende“ 

die  Funktionstasten  1 , 2 und  7 bis  10  beschriftet,  die  Tasten  3 bis  6 behalten  jeweils  ihren 
alten  Wert.  Es  sind  nur  die  ersten  8 Zeichen  jeder  Tastenbeschriftung  signifikant. 


VOID  draw_func  (VOID); 

Die  Funktionstasten  werden  auf  dem  Desktops  gezeichnet. 


VOID  draw_key  (WORD  key); 

Eine  einzelne  von  10  Funktionstasten  wird  gezeichnet.  Die  Funktionstasten  werden  von 
eins  beginnend  durchnumeriert. 

key:  Nummer  der  Funktionstaste  (1  — 10) 


VOID  set_deskinfo  (CONST  BYTE  *info,  BOOLEAN  center); 

Die  Infozeile  des  Desktops  wird  besetzt. 

info  : Zeiger  auf  die  Zeichenkette,  die  in  die  Infozeile  gesetzt  werden  soli 
center  ; TRUE,  wenn  die  Zeichenkette  zentriert  werden  soli,  FALSE  sonst 

Befmdet  sich  der  Desktop  in  einetn  Fenster,  so  wird  die  Infozeile  des  Fensters  gesetzt. 
In  diesem  Fall  wird  der  Parameter  „center“  nicht  beriicksichtigt,  sondern  die  Infozeile 
von  links  beginnend  ausgegeben. 
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VOID  set_meminfo  (VOID); 

Die  Speicherinformation  wird  angezeigt.  Sie  befindet  sich  in  unserer  Beispielapplikation 
in  der  rechten  unteren  Ecke.  Es  handeit  sich  una  die  Anzahl  des  noch  verfiigbaren  freien 
Hauptspeichers  in  Kilobytes. 


WINDOW?  crt_desktop  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 


Das  Desktopfenster  wird  kreiert. 


crt_desktop : 
obj  : 

menu 


icon 


Zeiger  auf  das  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden  konnte 
Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soli,  also 
der  eigene  Desktop 

Meniizeile,  welche  sich  im  Desktopfenster  befinden  soil,  oder  NULL, 
wenn  sich  nur  die  globale  Meniizeile  am  oberen  Rand  des  Bildschirms  be- 
findet 

Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 


Beim  Kreieren  wird  beriicksichtigt,  ob  die  Klasse  des  Desktops  DESK  oder  DESKWIN- 
DOW  ist,  es  sich  also  um  den  Desktop  handeit,  welcher  den  GEM-Desktop  ersetzt,  oder 
urn  einen  Desktop,  der  sich  in  einem  Fenster  befindet.  Letzteres  ist  bei  X/GEM  der  Fall 
Oder  bei  Accessories,  welche  einen  eigenen  Desktop  bendtigen  (man  denke  an  WORD- 
PLUS,  das  als  Accessory  iaufen  soli). 


Die  Werte  der  Fensterstruktur  werden  hier  eingesetzt.  Die  Faktoren  XFAC  und  YFAC 
sind  jeweils  zwei,  da  der  Desktop  minimal  um  zwei  Pixel  je  Richtung  gescrollt  werden 
darf.  Sonst  gibt  es  Probleme  beim  Zeichnen  des  „grau  gemusterten"  Desktop- 
Hintergrundes. 

Die  beiden  Komponenten  „hndl_menu“  und  „updt_menu“  des  Desktops  werden  auf 
die  entsprechenden  globalen  Funktionen  des  Moduls  MENU  gesetzt.  Der  Grund  dafiir 
ist  darin  zu  suchen,  daB  es  sich  bei  der  Meniizeile  des  Desktops  meistens  um  die  globale 
GEM-Meniizeile  handeit.  Selbst  wenn  dies  nicht  der  Fall  ist  (Accessories  mit  eigener  Me- 
niizeile),  werden  diese  richtig  gehandhabt,  da  die  Parameter  der  beiden  globalen  Funktio- 
nen korrekt  angegeben  wurden  (siehe  auch  Modul  MENU).  Damit  kann  auch  der  inte- 
grierte  Menu-Manager,  der  die  Meniizeilen  in  Fenstern  verwaltet,  die  beiden  Funktionen 
richtig  aufrufen. 

Liegt  der  Desktop  in  einem  Fenster  und  ist  ein  Objektbaum  vorhanden,  so  mufl  die  Doku- 
mentgrdbe  angepaflt  werden,  wenn  die  Objektbaumbreite  oder  -hdhe  groBer  als  die  des 
physikalischen  Desktops  ist.  Ist  kein  Objektbaum  vorhanden,  so  werden  imraer  groBe 
Schieber  gezeigt. 


463 


6.5  Modulbe.ichreibung 


Existiert  ein  Objektbaum,  so  wird  das  Fenster  so  positioniert,  dafi  der  untere  Toil  des 
Desktops  gezeigt  wird.  In  unserem  Fall  ist  dies  giinstig,  da  sich  doit  die  Funktionstasten 
befinden. 


BOOLEAN  open_desktop  (WORD  icon); 

Das  Desktopfenster  wird  geoffnet. 

open_ desktop : TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 

Beim  Offnen  des  Desktops  wird  zunachst  festgestellt,  ob  es  sich  um  einen  Desktop  han- 
delt,  der  den  Desktop  des  GEM  ersetzt.  Ist  dies  der  Fail,  so  wird  das  Flag  HIDETREE 
der  Infozeile  im  Objektbaum  (DESKINFO)  geloscht,  damit  dieses  sichtbar  ist.  Im  ande- 
ren  Fall  (Desktop  im  Fenster)  wird  versucht,  die  globale  Menuzeile  in  das  Desktopfenster 
zu  legen.  Dies  geschieht  aber  nur,  wenn  die  Menuzeile  entweder  nicht  auf  den  normalen 
Bildschirm  paBt  (zu  breit  ist)  oder  es  sich  um  ein  Deskaccessory  handelt. 

Dann  wird  festgestellt,  ob  bereits  ein  Desktop  kreiert  wurde,  da  es  nur  maximal  einen 
Desktop  geben  kann.  Ist  dies  nicht  der  Fall,  so  wird  ein  Desktop  iiber  die  Funktion 
„crt_desktop“  kreiert. 

Hat  das  Kreieren  geklappt  oder  existiert  bereits  ein  Desktop,  so  wird  dieser  durch  ein 
„open  window"  geoffnet,  wenn  er  noth  nicht  offen  war.  Ansonsten  wird  er  durch  ein 
„top_window“  nach  oben  gebracht. 


BOOLEAN  info_desktop  (WINDOWP  window,  WORD  icon); 

Die  Information  des  Desktops  wird  angezeigt.  Es  handelt  sich  hier  um  dieselbe  Informa- 
tion wie  beim  Auswahlen  des  Menus  „Uber...“. 

info_desktop  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 

Die  Parameter  „window“  und  „icon“  sind  hier  ohne  Bedeutung  und  nur  der  Vollstiindig- 
keit  der  Schnittstelle  halber  mit  aufgenommen  worden.  Sie  werden  genau  dann  benotigt, 
wenn  man  zu  verschiedenen  Inkarnationen  derselben  Fensterklasse  verschiedene  Infor- 
mationen zeigen  will.  Dann  zeigt  „ window"  genau  auf  das  entsprechende  Fenster.  Ist  die- 
ses nicht  bekannt,  aber  das  Piktogramm,  aus  dem  das  Fenster  entstanden  ist,  so  kann  man 
auch  dieses  angeben.  Uber  ein  „search  window"  kann  man  dann  das  eindeutige  zuge- 
horige  Fenster  finden.  Im  Modul  EDIT  wird  ein  Beispiei  fur  diese  Parameter  gegeben. 
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BOOLEAN  help_desktop  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fur  den  Desktop  wird  angezeigt.  In  unserem  Beispielprogranun  haben 
wir  keine  Hilfemeldung  eingebaut. 

help_desktop:  TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

Die  Parameter  „window“  und  „icon“  sind  bier  obne  Bedeutung  und  nur  wegen  der  Voll- 
standigkeit  der  Scbnittstelle  balber  mit  aufgenommen  worden.  Sie  werden  genau  dano  be- 
notigt,  wenn  man  zu  verscbiedenen  Inkarnationen  derselben  Fensterklasse  verscbiedene 
Hilfemeldungen  benotigt.  Dann  zeigt  „window“  auf  das  entsprechende  Fenster.  1st  dieses 
nicbt  bekannt,  aber  das  Piktogramm,  aus  dem  das  Fenster  entstanden  ist,  so  kann  man 
aucb  dieses  angeben.  Uber  ein  „seareb_window“  kann  man  dann  das  eindeutige  zuge- 
horige  Fenster  finden. 


BOOLEAN  init_desktop  (VOID); 

Das  Modul  wird  initialisiert. 

init_desktop:  TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 


BOOLEAN  term_desktop  (VOID); 

Das  Modul  wird  terminiert. 

term_desktop:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 

Im  Desktop  gibt  es  eine  Menge  lokaler  Funktionen,  auf  die  aber  bier  nicbt  naher  einge- 
gangen  werden  soil.  Wir  verweisen  nur  auf  den  kommentierten  Quelltext,  der  auf  Disket- 
te vorhanden  ist.  Ahnliches  gilt  aucb  fiir  die  weiteren  Module.  Die  Kapazitat  des  Buches 
wurde  leicht  gesprengt  werden,  wenn  die  lokalen  Funktionen  aller  Module  in  alien  Details 
erklart  werden  wiirden. 


6.5.10  Modul  CLIPBRD 

Das  Modul  verwaltet  das  Klemmbrett.  Dieses  wird  ahnlich  verwaltet  wie  ein  Fenster  im 
GEM-Desktop,  d.h.  alle  Dateien  werden  angezeigt  und  konnen  durch  Doppelklick  geoff- 
net  werden.  In  diesem  Modul  sind  auilerdem  Funktionen  zu  finden,  welche  die  fehlenden 
Scrap-Funktionen  aus  GEM/3  im  alten  GEM  nachbildet. 


6.5  Modulbeschreihung 
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WORD  scrap_read  (BYTE  *pscrap); 

Die  Funktion  ersetzt  die  nicht  richtig  arbeitende  Funktion  „srcp_read“  der  Versionen 
von  GEM,  die  vor  GEM/3  auf  den  Markt  kamen. 

scrap_read:  Bitkombination  der  Standarddateien,  die  sich  im  GEM -Clipboard  befin- 
den,  Oder  - 1 , wenn  kein  Clipboard-Pfad  gesetzt  ist  (siehe  Beschreibung 
„scrp_read"  in  Kapitel  2). 

pscrap  : Zeiger  auf  die  Zeichenkette,  die  nach  dem  Aufruf  den  aktuellen  Clipboard- 
Pfad  enthalt 


WORD  scrap„ write  (BYTE  *pscrap); 

Die  Funktion  hat  die  gleiche  Wirkung  wie  „scrp_write“  des  AES  und  ist  nur  der  Voll- 
standigkeit  halber  aufgenommen  worden. 

scrap_write:  Funktionswert  der  AES-Funktion  „scrp_ write" 

pscrap  : Zeiger  auf  die  Zeichenkette,  die  den  neuen  GEM -Clipboard-Pfad  enthalt 


WORD  scrap_clear  (VOID); 

Die  Funktion  ersetzt  die  fehlende  Funktion  „srcp_clear"  der  Versionen  von  GEM,  die 
vor  GEM/3  auf  den  Markt  kamen. 

scrap_clear:  0,  wenn  ein  Fehler  aufgetreten  ist,  > 0 sonst 

Es  werden  alle  Dateien  SCRAP.*  geloscht.  Fur  neuere  GEM-Versionen  wird  die  einge- 
baute  Funktion  „scrp_clear“  benutzt. 


VOID  get_clipxywh  (WORD  obj,  RECT  *border); 


Das  Rechteck  eines  Objekts  (z.B.  eines  Piktogramms)  im  Clipboard-Fenster  kann  ermit- 
telt  werden. 

obj  : Index  des  Objekts 
border  : Umrandung  des  Objekts 

Ist  das  Clipboard-Fenster  nicht  vorhanden  oder  geschlossen  oder  „obj‘‘  NIL,  so  wird  ein 
Rechteck  ohne  Breite  und  Hohe  (jeweils  null)  zuriickgegeben.  Die  Koordinaten  sind  dann 
ebenfalls  null. 
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VOID  print_clipfiles  (WINDOWP  window,  SET  objs); 


Die  Dateien  des  Klenimbretts  werden  ausgedruckt. 
window:  Zeiger  auf  das  Clipboard-Fenster 

objs  ; Zeiger  auf  die  Menge  der  Objekte,  die  ausgedruckt  werden  soli 


BOOLEAN  icons_clipbrd  (WORD  src_.obj,  WORD  dest_obj); 

Operationen  fiir  das  Klemmbrettpiktogramm  werden  durchgefiihrt.  Diese  Funktion  wird 
vom  Desktop  aufgerufen,  wenn  das  Klemmbrettpiktogramm  auf  ein  anderes  Piktogramm 
verschoben  wird. 

icons_clipbrd:  TRUE,  wenn  es  eine  giiltige  Piktogramm-Operation  gab,  FALSE  sonst 
src  _obJ  : Index  des  Qucllobjektes 

dest_obj  : Index  des  Zielobjektes 

Je  nach  Objekttyp  wird  eine  entsprechende  Operation  durchgefiihrt.  Beim  Ziehen  des 
Klemmbretts  auf  den  Papierkorb  wird  ein  ,,scrap_clear“  aufgerufen.  Wird  es  auf  den 
Drucker  gezogcn,  werden  alle  Objekte  ausgedruckt. 


WINDOWP  crt_clipbrd  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 
Ein  Klemmbrettfenster  wird  kreiert. 


crt_clipbrd: 

obj 

menu 

icon 


Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soli 
Menuzeile,  welche  sich  im  Fenster  befinden  soil,  oder  NULL,  wenn  es 
keine  Meniizeiie  geben  soli 

Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 


Beim  Kreieren  werden  die  schon  existierenden  Fenster  der  gleichen  Klasse  gezahlt.  Neue 
Fenster  dieser  Klasse  offnen  sich  dann  leicht  versetzt,  so  daB  sie  sich  nicht  vollstiindig 
verdecken. 


Die  Dokumentbreite  wird  abhangig  davon  gesetzt,  wie  der  Schalter  im  Klemmbrettmenii 
steht,  welcher  angibt,  ob  die  Dateien  als  Piktogramme  (zweidimensional)  oder  als  Text 
(eindimensional)  angezeigt  werden  sollen. 


6.5  Modulbesckreibung 
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BOOLEAN  open  „ dipbrd  (WORD  icon); 

Ein  Klemmbrettfenster  wire!  geoffnet. 

open._clipbrd:  TRUE,  wenn  das  Fenster  geoifnet  warden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 

Beim  Offnen  des  Klemmbretts  wird  zunaebst  festgestellt,  ob  es  bereits  ein  offenes 
Klemmbrettfenster  gibt.  Falls  dies  der  Fall  ist,  wird  es  nach  oben  gebracht. 

Im  anderen  Fall  wird  festgestellt,  ob  es  bereits  ein  geschlossenes  (kreiertes)  Klemmbrett- 
fenster gibt,  da  in  dieser  Applikation  nur  maximal  ein  Klemmbrettfenster  geoffnet  werden 
kann.  Ist  dies  nicht  der  Fall,  so  wird  ein  Fenster  iiber  die  Funktion  „crt_clipbrd“ 
kreiert. 

Hat  das  Kreieren  geklappt  oder  existiert  bereits  ein  Fenster,  so  wird  dieses  durch  ein 
„open_ window"  geoffnet. 


BOOLEAN  info_clipbrd  (WINDOWP  window,  WORD  icon); 

Die  Information  des  Klemmbretts  wird  angezeigt. 

info dipbrd:  TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 

Znnachst  wird  der  Parameter  „icon“  ausgewertet.  Ist  er  ungleich  NIL,  so  handelt  es  sich 
um  ein  ganz  beslimmtes  Fenster,  das  aus  einem  ganz  bestimmten  Piktogramm  erzeugt 
wurde.  Dieses  Fenster  wird  nun  uber  „search  window"  gesucht. 

Wurde  ein  solches  Fenster  gefunden  oder  war  kein  Piktogramm  angegeben  (NIL),  dafiir 
aber  ein  Fenster,  so  wird  das  Menu  „mclipinfo“  aufgerufen.  Es  befmdet  sich  lokal  in 
diesem  Modul  und  kann  auch  iiber  das  Menii  des  Fensters  aufgerufen  werden. 


BOOLEAN  help dipbrd  (WINDOWP  window,  WORD  icon); 

Eine  Hilfemeldung  fiir  das  Klemmbrettfenster  oder  -piktogramm  wird  angezeigt. 

help_clipbrd:  TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  ; Index  des  Piktogramms.  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

Fur  die  Parameter  gilt  das  bei  „help  desktop"  Gesagte. 
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BOOLEAN  init„clipbrd  (VOID); 

Das  Modul  wird  initialisiert. 

init__clipbrd:  TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 

BOOLEAN  term_clipbrd  (VOID); 

Das  Modul  wird  terminiert. 

term_clipbrd:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.11  Modul  DISK 

Das  Modul  bietet  eine  Verwaltung  des  Diskettenpiktogramms  im  Desktop.  Es  hat  in  unse- 
rer  Applikation  allerdings  keine  Bedeutung. 


WINDOW?  crt_disk  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 

Ein  Diskettenfenster  wird  kreiert. 

crt_disk:  Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

obj  : Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soli 

menu  : Meniizeile,  welche  sich  im  Fenster  befinden  soil,  oder  NULL,  wenn  es  keine 

Meniizeile  geben  soli 

icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL,  wenn 
es  kein  solches  Piktogramm  gibt 


BOOLEAN  open_disk  (WORD  icon); 

Ein  Diskettenfenster  wird  gedffnet. 

open...disk:  TRUE,  wenn  das  Fenster  gedffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL,  wenn 
es  kein  solches  Piktogramm  gibt 


BOOLEAN  info.. disk  (WINDOW?  window,  WORD  icon); 

Die  Information  des  Diskettenfensters  oder  Piktogramms  wird  angezeigt. 
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info_disk 

window 

icon 


TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


BOOLEAN  help_disk  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fiir  das  Diskettenfenster  oder  -piktogramm  wird  angezeigt. 

help_disk  : TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

Fiir  die  Parameter  gilt  das  bei  „help_desktop“  Gesagte. 


BOOLEAN  init_disk  (VOID); 

Das  Modul  wird  initialisiert. 

jnit_disk  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 

BOOLEAN  term_disk  (VOID); 

Das  Modul  wird  terminiert. 

term_disk  : TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.12  Modul  PRINTER 

Das  Modul  bietet  eine  Verwaltung  des  Druckerpiktogramms  im  Desktop.  Es  hat  in  unse- 
rer  Applikation  allerdings  keine  Bedeutung.  Es  dient  lediglich  anderen  Piktogrammen  als 
Ziel  fur  die  Ziehbewegung. 


WINDOW?  crt  printer  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 
Ein  Druckerfenster  wird  kreiert. 


crt_printer  : 

obj  ; 

menu  ; 

icon  ; 


Zeiger  auf  das  kreierte  Fenster  Oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befmden  soli 
Meniizeile,  welche  sich  im  Fenster  befinden  soli,  oder  NULL,  wenn  es 
keine  Meniizeile  geben  soil 

index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 
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BOOLEAN  open_printer  (WORD  icon); 

Ein  Druckerfenster  wird  geoffnet. 

open_printer:  TRUE,  wenn  das  Fcnstcr  geoffnet  werden  ktmntc,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fcnster  entstehen  soli,  odcr  NIL, 

wcnn  es  kein  solches  Piktogramni  gibt 


BOOLEAN  info_printer  (WINDOW?  window,  WORD  icon); 

Die  Information  des  Druckerfensters  oder  Piktogramms  wird  angezeigt. 

info_printer  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zciger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


BOOLEAN  help_printer  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fur  das  Druckerfenster  oder  -piktogramin  wird  angezeigt. 

help_printer  ; TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zciger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

Fur  die  Parameter  gilt  das  bei  „help_desktop“  Gesagte. 


BOOLEAN  init_printer  (VOID); 

Das  Modul  wird  initialisiert. 

init_.printer  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 


BOOLEAN  term_printer  (VOID); 

Das  Modul  wird  terminiert. 

term_printer : TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.13  Modul  TRASH 

Das  Modul  bietet  eine  Verwaltung  des  Papierkorbpiktogramms  im  Desktop,  Es  hat  in  un- 
serer  Applikation  allerdings  keine  Bedeutung,  auller  dafi  es  geoffnet  werden  kann.  Es 
dient  aulkrdem  anderen  Piktogrammen  als  Ziel  fur  die  Ziehbewegung. 
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WINDOWP  crt_trash  (OBJECT  *=obj,  OBJECT  *mcnu,  WORD  icon); 
Ein  Papierkorbfenster  wird  kreiert. 


crt_trash 

obj 

menu 

icon 


; Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

; Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  sol] 

: Meniizeile,  welche  sich  im  Fenster  befinden  soil,  Oder  NULL,  wenn  es 
keine  Menuzeile  geben  soil 

: Index  des  Piktogramms,  aus  dcm  das  Fenster  entstehen  soil,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 


BOOLEAN  open_trash  (WORD  icon); 

Ein  Papierkorbfenster  wird  geoffnet, 

open_trash  ; TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 

Es  wird  maximal  ein  Papierkorbfenster  erzeugt.  Aus  diesem  Grund  lauft  der  Algorithmus 
genauso  ah  wie  der  Algorithmus  beim  Offnen  des  Klemmbrettpiktogramms. 


BOOLEAN  info_trash  (WINDOWP  window,  WORD  icon); 

Die  Information  des  Papierkorbfensters  oder  Piktogramms  wird  angezeigt. 

info_trash  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


BOOLEAN  help  , trash  (WINDOWP  window,  WORD  icon); 

Eine  Hilfemeldung  fur  das  Papierkorbfenster  oder  -piktogramm  wird  angezeigt. 

help_trash  : TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 


Fiir  die  Parameter  gilt  das  bei  „help  desktop"  Gesagte. 
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BOOLEAN  init_trash  (VOID); 

Das  Modul  wird  initialisiert. 

init  ,_trash  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 

Beim  Initialisieren  wird  sofort  ein  Papierkorbfenster  kreiert,  da  dann  inuner  eine  Infor- 
mation moglich  ist,  auch  wenn  noch  kein  Fenster  geoffnet  ist. 

BOOLEAN  term_trash  (VOID); 

Das  Modul  wird  terminiert. 

term_..trash  : TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.14  Modul  IMAGE 


Das  Modul  bietet  die  Darstellung  von  Bit-Image-Dateien  in  einem  Fenster. 

WINDOW?  crt__image  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon, 
BYTE  *filename); 


Ein  Fenster  zur  Darstellung  einer  Bit-Image-Datei  wird  kreiert. 


crt_image 

obj 

menu 

icon 

filename 


Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soil 
Meniizeile,  welche  sich  im  Fenster  befinden  soli,  oder  NULL,  wenn  es 
keine  Meniizeile  geben  soil 

Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 
Zeiger  auf  den  Namen  der  Bit-Image-Datei 


Ist  kein  Pfad  im  Dateinamen  angegeben,  so  wird  der  aktuelle  Pfad  mit  aufgenommen. 


BOOLEAN  open  image  (WORD  icon,  BYTE  *filename); 

Ein  Fenster  zur  Darstellung  einer  Bit-Image-Datei  wird  geoffnet. 

open..,  image:  TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 
filename  : Zeiger  auf  den  Namen  der  Bit-Image-Datei 
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Wenn  ein  ganz  bestimmtes  Piktogramm,  z.B.  aus  dem  Klemmbrettfenster,  gemeint  ist, 
so  wird  dieses  nach  oben  gebracht,  wenn  es  bereits  offen  ist.  Ansonsten  wird  ein  neues 
Fenster  kreiert,  wenn  nicht  bereits  ein  geschlossenes  Fenster  vorhanden  ist.  Dieses  Fen- 
ster  wird  dann  geoffnet. 


BOOLEAN  info_image  (WINDOW?  window,  WORD  icon); 

Die  Information  des  Bit-Image-Fensters  wird  angezeigt. 

info_image  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


BOOLEAN  help_image  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fiir  das  Bit-Image-Fenster  wird  angezeigt. 

help_image : TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

Fiir  die  Parameter  gilt  das  bei  „help_desktop“  Gesagte. 


BOOLEAN  init^image  (VOID); 

Das  Modul  wird  initialisiert. 

init_image  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 


BOOLEAN  term_image  (VOID); 

Das  Modul  wird  terminiert. 

term_image:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.15  Modul  META 

Das  Modul  bietet  die  Darstellung  von  Metadateien  in  einem  Fenster. 

WINDOW?  crt_meta  (OBJECT  *obj.  OBJECT  *menu,  WORD  icon, 
BYTE  ^filename); 
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Ein  Fenster  zur  Darstellung  einer  Metadatei  wird  kreiert. 


crt_tneta 

obj 

menu 

icon 

filename 


: Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

: Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  bcfinden  soli 
: Menuzeile,  welche  sich  im  Fenster  befinden  soli,  Oder  NULL,  wenn  es 
keine  Meniizeile  geben  soil 

: Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  txler  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 
: Zeiger  auf  den  Namen  der  Metadatei 


1st  kein  Pfad  im  Dateinamen  angegeben,  so  wird  der  aktuelle  Pfad  mit  aufgenommen. 


BOOLEAN  open_meta  (WORD  icon,  BYTE  *filename); 

Ein  Fenster  zur  Darstellung  einer  Metadatei  wird  geoffnet. 

open_meta  : TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 
filename  : Zeiger  auf  den  Namen  der  Metadatei 

Wenn  ein  ganz  bestimmtes  Piktogramm,  z.B.  aus  dem  Klemmbrettfenster,  gemeint  ist, 
so  wird  dieses  nach  oben  gebracht,  wenn  es  bereits  offen  ist.  Ansonsten  wird  cin  neues 
Fenster  kreiert,  wenn  nicht  bereits  ein  geschlossenes  Fenster  vorhanden  ist.  Dieses  Fen- 
ster wird  dann  geoffnet. 


BOOLEAN  info^meta  (WINDOWP  window,  WORD  icon); 

Die  Information  der  Metadatei  wird  angezeigt. 

info^meta  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


BOOLEAN  help  meta  (WINDOWP  window,  WORD  icon); 

Eine  Hilfemeldung  fiir  die  Metadatei  wird  angezeigt. 

help  meta  r TRUE,  wenn  es  eine  Hilfemeldung  gibt.  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  ; Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 

Fiir  die  Parameter  gilt  das  bei  „help  desktop"  Gesagte. 
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BOOLEAN  init_meta  (VOID); 

Das  Modul  wird  initialisiert. 

init  mcta  : TRUE,  wenn  die  Initialisierung  geklappt  hal,  FALSE  sonst 


BOOLEAN  term  mcta  (VOID); 

Das  Modul  wird  terminiert. 

term_meta  : TRUE,  wenti  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.16  Modul  EDIT 

Das  Modul  bietet  die  Darstellung  von  editicrbaren  ASCII-Dateien  in  eineiti  Fenster.  Die 
Routinen  zum  eigentlichen  Editieren  sind  aber  noch  nicht  eingebaut,  so  daft  die  Dateien 
nur  angezeigt  werden  konnen. 

WINDOW?  crt_edit  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon, 

BYTE  *filename); 

Ein  Fenster  zur  Darstellung  einer  ASClI-Datei  wird  kreiert. 

crt_edit  : Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

obj  : Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soil 

menu  : Meniizeile,  welche  sich  im  Fenster  befinden  soli,  oder  NULL,  wenn  es 

keine  Meniizeile  geben  soli 

icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 
filename  : Zeiger  auf  den  Namen  der  ASCII  Datei 

1st  kein  Pfad  im  Dateinamen  angegeben,  so  wird  der  aktuelle  Pfad  mit  aufgenommen. 


BOOLEAN  open  edit  (WORD  icon,  BYTE  *filename); 

Ein  Fenster  zur  Darstellung  einer  ASCII-Datei  wird  geoffnet. 

open_edit  ; TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 
filename  : Zeiger  auf  den  Namen  der  ASCII-Datei 
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Wenn  ein  ganz  bestimmtes  Piktogramm,  z.B.  aus  dem  Klemmbrettfenster,  gemeint  ist, 
so  wird  dieses  nach  oben  gebracht,  wenn  es  bereits  offen  ist.  Ansonsten  wird  ein  neues 
Fenster  kreiert,  wenn  nicht  bereits  ein  geschlossenes  Fenster  vorhanden  ist.  Dieses  Fen- 
ster  wird  dann  geoffnel. 


BOOLEAN  info_edit  (WINDOW?  window.  WORD  icon); 

Die  Information  der  ASCII-Datei  wird  angezeigt. 

info_edit  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


BOOLEAN  help_edit  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fiir  die  ASCII-Datei  wird  angezeigt. 

help_edit  : TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

Fiir  die  Parameter  gilt  das  bei  „help_desktop“  Gesagce. 


BOOLEAN  init_edit  (VOID); 

Das  Modul  wird  initialisiert. 

init_edit  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 


BOOLEAN  term_edit  (VOID); 

Das  Modul  wird  terminiert. 

term_edit  : TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.17  Modul  POWER 

Das  Modul  dient  der  Darstellung  von  Potenzen  einer  Zahl  in  einem  Fenster.  Dazu  kommt 
ein  Beispiel  fur  die  Benutzung  eines  Pop-Up-Meniis. 
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WINDOW?  crt  power  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 


Ein  Fenster  zur  Darstellung  von  Potenzen  einer  Zahl  wird  kreiert. 


crt_power 

obj 

menu 

icon 


Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soli 
Meniizeile,  welche  sich  im  Fenster  befinden  soli,  oder  NULL,  wenn  es 
keine  Meniizeile  geben  soli 

Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 


Das  kreierte  Fenster  wird  eine  eigene  Mausform  haben  (USER_DEF). 


Beim  Kreieren  werden  unter  anderem  auch  die  Funktionen  der  Fensterstruktur  einge- 
hangt.  Dadurch  kann  der  Window-Manager  diese  Funktionen  bei  Bedarf  aufrufen.  Eine 
dieser  Funktion  ist  die  „click“-Funktion,  die  aufgerufen  wird,  wenn  in  das  Fenster  ge- 
klickt  wird.  Sie  ist  lokal  in  diesem  Modul  als  ,,wi„click“  definiert. 


Nach  dem  Klick  wird  zunachst  ein  etwaiges  anderes  Fenster  deselektiert.  Dann  werden 
im  Meniibaum  „popup“  bei  alien  Menus  des  Objekts  POWERS  die  Hakchen  entfernt. 
Die  aktuell  eingesiellte  Potenz  wird  abgehakt.  Dann  wird  die  Funktion  „popup_menu“ 
aufgerufen.  An  sie  wird  das  Pop-Up-Menii  iibergeben.  Das  Menii  soli  relativ  zur  Maus- 
position  ohne  zusatzlichen  Offset  erscheinen.  AuBerdem  soil  die  Mausform  genau  in  der 
Mitte  der  aktuell  eingestellten  Potenz  erscheinen  (zentriert).  Es  wird  dann  auf  das  Klicken 
Oder  Loslassen  des  linken  Mausknopfes  gewartet. 


BOOLEAN  open_power  (WORD  icon); 

Ein  Fenster  zur  Darstellung  von  Potenzen  einer  Zahl  wird  geoffnet. 

open_power  ; TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 

Es  wird  jeweils  gesucht,  ob  noch  ein  geschlossenes  Fenster  dieser  Klasse  vorhanden  ist. 
Wenn  ja,  dann  wird  dieses  geoffnet,  ansonsten  wird  ein  neues  Fenster  kreiert  und  dieses 
geoffnet. 


BOOLEAN  info_power  (WINDOWP  window,  WORD  icon); 

Die  Information  des  Fensters  wird  angezeigt. 

info_power : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 


478 


6 Ein  universelles  Modulkonzept  in  C 


BOOLEAN  help_power  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fur  das  Potenzfenster  wird  angezeigt. 

help_power:  TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  : Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

Fur  die  Parameter  gilt  das  bei  „help_desktop“  Gesagte. 


BOOLEAN  init_power  (VOID); 

Das  Modul  wird  initialisiert. 

init_power  ; TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 


BOOLEAN  term_.power  (VOID); 

Das  Modul  wird  terminiert. 

term_power;  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.18  Modul  GRAF 

Das  Modul  dient  der  Darstellung  einer  Grafik  (Ellipse)  in  verschiedenen  Formen.  AuBer- 
dem  wird  ein  Beispiel  fiir  eine  Art  Multitasking  gegeben. 

■3 


WINDOWP  crt_graf  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 


Ein  Fenster  zur  Darstellung  von  Grafik  wird  kreiert. 


crt_graf 

obj 

menu 

icon 


; Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

: Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soil 

: Meniizeile,  welche  sich  im  Fenster  befinden  soil,  oder  NULL,  wenn  es 
keine  Meniizeile  geben  soil 

: Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soli,  oder  NIL, 
wenn  es  kein  solches  Piktogramm  gibt 


Beim  Kreieren  werden  unter  anderem  auch  die  Funktionen  der  Fensterstruktur  einge- 
hangt.  Dadurch  kann  der  Window-Manager  diese  Funktionen  bei  Bedarf  aufrufen,  Eine 
dieser  Funktionen  ist  die  „timer“-Funktion,  die  aufgerufen  wird,  wenn  eine  bestimmte 
Zeitspanne  vergangen  ist.  Sie  ist  lokal  in  diesem  Modul  als  „wi_timer“  definiert. 


6.5  Modulhe.ichreihung 
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Am  Anfang  des  Moduls  wird  die  Zeit  als  Macro  definiert: 
# define  MILLI  1000 


Das  bedeutet,  dafi  je  weils  nach  Ablauf  einer  Sekunde  das  Fenster  eine  Aktion  durchfuhren 
kann,  wenn  eine  Funktion  dafur  vorhanden  und  in  die  Fensterstruktur  eingeklinkt  ist.  In 
unserer  Funktion  „wi_timer“  wird  ein  Tastaturereignis  fur  die  Taste  ’ + ’ f'iir  dieses 
Fenster  simuliert.  Diese  Taste  kann  auch  unabhiingig  vom  Zeitereignis  gednickt  werden. 
Dadurch  wird  das  Muster,  welches  im  Fenster  in  einer  Ellipse  gezeichnet  wird,  weiterge- 
schaltet.  Es  handelt  sich  dabei  um  die  GEM-Mustcr  aus  Abb.  2.8. 


Das  Zeitereignis  kann  immer  dann  auftreten,  wenn  in  der  Hauptereignisschleife  (Modul 
EVENT)  gewartet  wird.  Das  bedeutet,  dab  Dialogboxen  diese  Ereignisse  bremsen.  Die 
Tatigkeit,  die  ein  Fenster  nach  einem  Zeitereignis  durchfUhrt,  kann  mannigfaltig  sein. 
So  kbnnte  sich  hinter  diesem  Fenster  ein  Druckerspooler  verbergen,  der  im  Hintergrund 
Datcn  an  den  Drucker  sendet.  Ein  Fenster,  das  Text  anzeigt,  kbnnte  nach  Ablauf  einer 
bestimmten  Zeit  diesen  Text  abspeichem  usw. 


BOOLEAN  open_graf  (WORD  icon); 

Ein  Fenster  zur  Darstellung  von  Grafik  wird  gebffnet. 

open^graf  : TRUE,  wenn  das  Fenster  gebffnet  werden  konnte,  FALSE  sonst 
icon  : Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 


Es  wird  jeweils  gesucht,  ob  noch  ein  geschlossenes  Fenster  dieser  Klasse  vorhanden  ist. 
Wenn  ja,  dann  wird  dieses  gebffnet,  ansonsten  wird  ein  neues  Fenster  kreiert  und  dieses 
gebffnet. 


BOOLEAN  info,...graf  (WINDOW?  window,  WORD  icon); 


Die  Information  des  Fensters  wird  angezeigt. 


info_graf  : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  sollen 
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BOOLEAN  help_graf  (WINDOW?  window,  WORD  icon); 

Eine  Hilfemeldung  fur  das  Grafikfenster  wind  angezeigt. 

help  graf  : TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soli 

icon  ; Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigl  werden  soil 

Fiir  die  Parameter  gilt  das  bei  „help_desktop“  Gesagte. 

BOOLEAN  init_graf  (VOID); 

Das  Modul  wird  initialisiert. 

init_graf  : TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 

BOOLEAN  term_graf  (VOID); 

Das  Modul  wird  terminiert. 

term_graf  : TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 


6.5.19  Modul  MODULE 

Dieses  Modul  hat  noch  keine  Aufgabc.  Es  dient  als  Grundgeriist  fiir  das  Schreiben  von 
eigenen  Modulen.  Es  ist  so  aufgebaut,  dal)  alle  Funktionen,  die  ein  Modul  benotigt,  wel- 
ches Fenster  benutzt,  vorhanden  sind.  Aus  diesem  Grund  soil  das  Modul  eingehender  be- 
sprochen  werden.  Hier  werden  auch  alle  diejenigen  Funktionen  vorgestellt,  die  nur  lokal 
zu  dem  Modul  definiert  sind  und  bei  der  Besprechung  der  anderen  Module  zu  kurz  ge- 
kommen  sind. 

Die  Schnittstelie  des  Moduls  MODULE  entspricht  der  Schnittstelle  des  Moduls 
CLIPBRD.  Anstatt  von  „open_clipbrd“  taucht  hier  aber  z.B.  ein  „open_module“  auf. 
Das  bedeutet,  dal)  im  Quelltext  alle  Vorkommen  von  ..module"  durch  den  Namen  des 
Moduls  ersetzt  werden  sollen,  also  z.B.  durch  „draw“,  wenn  es  sich  urn  ein  Zeichenmo- 
dul  handelt.  Das  gleiche  gilt  fiir  alle  Vorkommen  des  Wortes  „MODULE“,  welches  dann 
analog  zu  oben  durch  „DRAW“  ersetzt  werden  sollte. 

AuBerdem  muB  der  Konstanten  ..CLASS  MODULE",  die  in  unserem  Beispiel  durch 
„CLASS_DRAW“  ersetzt  werden  wiirde,  ein  Wert  zugeordnet  werden,  der  noch  nicht 
eine  andere  Klasse  beschreibt. 


6.5  Modulbeschreibung 
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a)  Globale  Funktionen 

BOOLEAN  icons_module  (WORD  src_obj,  WORD  dest_obj); 

Operationen  fur  das  Piktogramm  des  Moduls  werden  durchgefuhrt.  Diese  Funktion  wird 
vom  iibergeordneten  Modul  aufgerufen,  wenn  das  Piktogramm  des  Moduls  auf  ein  ande- 
res  Piktogramm  verschoben  wird.  Die  Funktion  muB  nicht  existieren,  wenn  es  kein  Pikto- 
gramm gibt,  welches  das  Modul  reprasentiert. 

icons_module:  TRUE,  wenn  es  eine  giiltige  Piktogramm-Operation  gab,  FALSE  sonst 
src_obj  : Index  des  Quellobjektes 

dest_obj  : Index  des  Zielobjektes 

Falls  es  ein  Fenster  gibt,  welches  zu  einem  Piktogramm  gehort,  so  wird  dieses  zunachst 
gesucht.  In  der  zugehorigen  Fensterstruktur  sind  mit  groBer  Wahrscheinlichkeit  Informa- 
tionen  zu  fmden,  die  benutzt  werden  kdnnen,  urn  die  Operation  auszufiihren  (siehe  auch 
„ icons_clipbrd  “ ) . 


WINDOWP  crt_module  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon); 

Ein  Fenster  des  Moduls  wird  kreiert. 

crt_module  : Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kreiert  werden 
konnte 

obj  : Zeiger  auf  den  Objektbaum,  welcher  sich  im  Fenster  befinden  soli 

menu  : Meniizeile,  welche  sich  im  Fenster  befinden  soil,  oder  NULL,  wenn  es 

keine  Menuzeile  geben  soil 

icon  ; Index  des  Piktogramms,  aus  dem  das  Fenster  entstehen  soil,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 

Beim  Kreieren  werden  die  schon  existierenden  Fenster  der  gleichen  Klasse  gezahlt  (inx). 
Neue  Fenster  dieser  Klasse  offnen  sich  dann  leicht  versetzt,  so  daB  sie  sich  nicht  vollstan- 
dig  verdecken. 

AnschlieBend  wird  ein  Fenster  iiber  den  Aufruf  „create_. window"  kreiert. 

Wenn  das  Kreieren  geklappt  hat,  so  wird  die  Hohe  der  Menuzeile  berechnet,  falls  das 
Fenster  eine  Menuzeile  besitzt.  Nun  werden  die  einzelnen  Komponenten  der  Fenster- 
struktur gefullt.  Fiir  die  Flags  wird  das  entsprechende  Macro  benutzt,  das  am  Anfang 
des  Moduls  definiert  wurde. 

Die  Dokumentposition  wird  auf  den  linken  oberen  Punkt  gesetzt,  die  Dokumentbreite  auf 
die  anfanglich  gesetzte  Breite  und  die  Dokumenthdhe  auf  null.  Die  beiden  letzten  Werte 
hangen  natiirlich  vom  Inhalt  des  Dokuments  ab.  Bei  einem  Texteditor  wiirden  hier  die 
Anzahl  der  Zeilen  und  die  maximale  Anzahl  der  Spalten  eingetragen  werden. 
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Der  X-Faktor  und  der  Y-Faktor  werden  durch  Makros  gesetzt,  die  im  Modul  definiert 
wurden.  Das  gleidie  gilt  fur  den  Scrolibcrcich.  Bei  dessen  Initialisierung  wird  zusatzlich 
noch  der  am  Anfang  berechnete  Index  benutzl,  damit  die  Bercichc  nicht  ubereinander  zu 
liegen  kommen.  Bei  der  Y-Position  mull  auBerdem  darauf  geachtet  werden,  daB  sie  im- 
mer  an  einer  geraden  Position  beginnt.  Das  Makro  „INITY“  ist  bereits  gerade,  die  Varia- 
ble „gl__hbox“  ebenfalls.  Nun  hangt  es  nur  noch  von  der  Hohe  der  Meniizeile  ab,  ob 
der  Wert  gerade  ist  oder  nicht.  Ist  die  Hdhe  ungerade,  so  wird  ein  Pixel  addiert. 

Der  Workbereich  wird  nun  ebenfalls  gesetzt.  Er  ist  so  groB  wie  der  Scrollbereich  zuzQg- 
lich  der  cventuell  vorhandenen  Meniizeile,  fur  die  das  Fenster  ja  nicht  verantwortlich  ist. 
Will  man  einen  grbfieren  Workbereich  haben,  weil  man  noch  Randkomponenten  benotigt 
(Panels  etc.  siehe  Abb.  6.3),  so  muB  man  entsprechende  Werte  vom  linken  bzw.  vom 
oberen  Rand  abziehen  und  in  der  Breite  bzw.  der  Hohc  hinzuaddieren  (siehe  auch  Abb. 
6.4).  Im  Modul  CLIPBRD  wird  dies  Ciber  zwei  Makros  bewerkstelligt. 

Die  Mausnummer  wird  nun  eingetragen.  Falls  sie  den  Wert  25.5  (=  USER_DEF)  er- 
halt,  so  muB  auch  die  Adresse  einer  Mausform  eingetragen  werden  (siehe  auch  Modul 
POWER). 

Die  Anzahl  der  Millisekunden,  die  vergehen  sollen,  bevor  das  Fenster  eine  Aktion  durch- 
fiihren  darf,  wird  uber  ein  Makro  eingetragen.  In  unserem  Beispiel  sind  dies  1000  Millise- 
kunden, also  eine  Sekunde.  Wir  erinnern  uns,  daB  die  Auflosung  im  „cvnt  multi “-Auf- 
ruf  des  Moduls  EVENT  auf  100  Millisekunden  (1/10  Sekunde)  eingestellt  ist.  Falls  man 
kleinere  Werte  benotigt,  so  muB  man  die  Konstante  im  Modul  EVENT  verkleinern.  Wir 
weisen  jedoch  nochmals  ausdriicklich  darauf  hin,  daB  zu  klein  gewahlte  Werte  nicht  ge- 
nau  sind.  So  kann  man  bei  Einstellen  des  Wertes  1 nicht  erwarten,  daB  in  jeder  Milli- 
sekunde  ein  Ereignis  ausgelost  wird.  Dies  hangt  vom  Timer  des  Rechners  und  der  Genau- 
igkeit  des  GEM  ab.  Da  dies  aber  von  Rechner  zu  Rcchner  verschieden  ist,  sollte  man 
auf  zu  kleine  Werte  verzichten. 

Der  Wert  „special“  der  Fensterstruktur  wird  ebenfalls  eingetragen.  Meistens  handelt  es 
sich  um  einen  Zeiger  auf  irgendcine  Struktur,  die  dann  beliebige  Informationen  beinhal- 
ten  kann,  die  zu  einem  Fenster  gehoren  (siehe  z.B.  Modul  EDIT). 

Der  Objektbaum  und  die  Meniizeile  werden  aus  den  Parametern  von  „crt_module“  ein- 
getragen. 

Nun  foigt  das  Eintragen  aller  Funktionen,  die  unter  anderem  vom  Window-Manager  auf- 
gerufen  werden  konnen.  Alle  diese  Routinen  sind  lokal  in  diesem  Modul  definiert  und 
beginnen  mit  dem  Prafix  „wi_“.  Dies  gilt  fur  alle  Module.  Da  sie  lokal  definiert  sind, 
werden  die  Bezeichner  nicht  nach  auBen  getragen,  so  daB  es  zu  kcinen  Kontlikten  kom 
men  kann.  Die  Funktionen  werden  wciter  unten  erklart.  Mbchte  nian  an  eine  Stelle  keine 
Funktion  eintragen,  weil  eine  bestimmte  Operation  nicht  ausfiihrbar  ist  (z.B.  Anklicken 
des  Fensterinnern),  so  triigt  man  den  Wert  NULL  ein.  Dies  ist  allerdings  nicht  unbedingt 
notig,  da  beim  Kreieren  eines  Fensters  alle  Komponenten  mit  null  gefiillt  werden. 
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Am  Ende  werden  noch  die  Komponenten  „name‘‘  und  „info“  der  Fenster.struktur  gesetzt. 
Wir  haben  fiir  die  beiden  Zeichenkctten  jeweiis  Texte  in  der  Resource-Datei  definiert. 
Dies  hiingt  natiirlich  von  der  jeweiligcn  Anwendung  ab.  Beispiele  sind  in  alien  Modulen 
zu  finden,  die  Fenster  dffnen. 


BOOLEAN  open_niodule  (WORD  icon); 

Ein  Fenster  des  Moduls  wird  geoffnet. 

open_module : TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  FALSE  sonst 
icon  ; Index  des  Piktogramms,  aus  dem  das  Fenster  cntstchen  soli,  oder  NIL, 

wenn  es  kein  solches  Piktogramm  gibt 

In  diesem  Beispiel  gehen  wir  davon  aus,  daft  es  im  Prinzip  beliebig  viele  Fenster  (aber 
maximal  sieben  wegen  GEM)  geben  kann.  Zunachst  wird  gesucht,  ob  es  bereits  ein  ge- 
schlossenes  Fenster  gibt,  das  der  gleichen  Klassc  angehdrt  und  aus  demsclben  Pikto- 
gramm entstanden  ist  (oder  gar  keinem).  Dieses  wird  dann  geoffnet.  Gibt  es  kein  solches 
Fenster,  so  wird  ein  neues  kreiert.  Im  Erfolgsfall  wird  das  Fenster  geoffnet. 


BOOLEAN  info_module  (WINDOWP  window,  WORD  icon); 

Die  Information  des  Fensters  oder  des  Piktogramms,  aus  dem  das  Fenster  entstanden  ist, 
wird  angezeigt. 

info_module : TRUE,  wenn  es  Informationen  gibt,  FALSE  sonst 

window  : Zeiger  auf  das  Fenster,  von  dem  Informationen  gezeigt  werden  sollen 

icon  : Index  des  Piktogramms,  von  dem  Informationen  gezeigt  werden  soilen 

Zunachst  wird  der  Parameter  „icon“  ausgewertet.  Ist  er  ungleich  NIL,  so  handelt  es  sich 
um  ein  ganz  bestimmtes  Fenster,  das  aus  einem  ganz  bestimmten  Piktogramm  erzeugt 
wurde.  Dieses  Fenster  wird  nun  uber  „search^_window“  gesucht. 

Wurde  ein  solches  Fenster  gefunden  oder  war  kein  Piktogramm  angegeben  (NIL),  dafiir 
aber  ein  Fenster,  so  wird  eine  entsprechende  Notiz  ausgegeben.  Es  kann  aber  auch  eine 
zu  diesem  Modul  lokale  Funktion  aufgerufen  werden,  die  je  nach  Fenster  oder  Pikto- 
gramm unterschiedliche  Informationen  ausgeben  kann  (siche  auch  Modul  EDIT). 


BOOLEAN  help  module  (WINDOWP  window,  WORD  icon); 

Eine  Hilfemeldung  fiir  das  Fenster  oder  Piktogramm  wird  angezeigt. 

help  module:  TRUE,  wenn  es  eine  Hilfemeldung  gibt,  FALSE  sonst 
window  : Zeiger  auf  das  Fenster,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 
: Index  des  Piktogramms,  von  dem  eine  Hilfemeldung  gezeigt  werden  soil 


icon 
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Die  Parameter  „window“  und  „icon“  sind  hier  ohne  Bedeutung  und  nur  wegen  der  Voll- 
st^digkeit  der  Schnittsteile  mit  aufgenommen  worden . Sie  werden  genau  dann  bendtigt, 
wenn  man  zu  verschiedenen  Inkarnationen  derselben  Fensterklasse  verschiedene  Hilfe- 
meldungen  bendtigt.  Dann  zeigt  „window“  namlich  auf  das  entsprechende  Fenster.  1st 
dieses  nicht  bekannt,  aber  das  Piktogramm,  aus  dem  das  Fenster  entstanden  ist,  so  kann 
man  auch  dieses  angeben.  Uber  ein  „search_window“  (ahnlich  wie  bei 
„info_module“)  kann  man  dann  das  eindeutig  zugehdrige  Fenster  finden. 


BOOLEAN  init_module  (VOID); 

Das  Modul  wird  initialisiert. 

init._module;  TRUE,  wenn  die  Initialisierung  geklappt  hat,  FALSE  sonst 

In  dieser  Funktion  konnen  Variablen  initialisiert  werden,  Speicherplatz  angefordert  wer- 
den usw.  Beispiele  finden  sich  unter  anderem  in  den  Modulen  GLOBAL  und 
WINDOWS. 


BOOLEAN  term_module  (VOID); 

Das  Modul  wird  terminiert. 

term_clipbrd:  TRUE,  wenn  die  Terminierung  geklappt  hat,  FALSE  sonst 

Falls  beim  Initialisieren  des  Moduls  Speicher  angefordert  wurde,  so  wird  dieser  hier  wie- 
der  freigegeben. 


b)  Lokale  Definitionen 

Im  Modul  werden  einc  Vielzahl  von  lokalen  Definitionen  zu  finden  sein,  die  nur  das 
jeweilige  Modul  kennt.  Nach  dem  Einbinden  der  verschiedenen  Headerdateien  werden 
zunachst  Makros  definiert. 

KIND  gibt  die  Art  des  Fensters,  d.h.  die  GEM-Komponenten  an. 

FLAGS  gibt  die  Flags  aus  WINDOWS. H an,  die  gesetzt  werden  konnen. 

XFAC  ist  der  X-Faktor,  der  beim  horizontalen  Scrolling  beriicksichtigt  wird 

YFAC  ist  der  Y-Faktor,  der  beim  vertikalen  Scrolling  beriicksichtigt  wird 

INITX,  INITY,  INITW  und  INITH  definieren  das  Rechteck  des  Scrollbereichs.  Dieses 
wird  immer  angegeben.  Der  Workbereich  wird  dann  erst  in  „crt_module“  errechnet. 


6.5  Modulbeschreibung 
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MILLI  gibt  die  Anzahl  der  Millisekunden  an,  auf  die  ein  Fenster  warten  mochte,  bevor 
es  eine  Aktion  ausfiihrt. 


c)  Lokale  Funktionen 

Vor  der  Implementierung  der  lokalen  Funktionen  werden  zunachst  alle  Prototypen  ange- 
geben.  Alle  Funktionen,  die  in  die  Fensterstruktur  eingehangt  werden,  wurden  schon  in 
Kapitel  6.3  bei  der  Beschreibung  der  Struktur  gegeben.  Aus  diesem  Grund  sollen  sie  hier 
nur  noch  kurz  erwahnt  werden. 


VOID  update_menu  (WINDOW?  window); 

Die  Funktion  wird  in  die  Komponente  „updt„menu“  der  Fensterstruktur  eingehangt, 
wenn  eine  Meniizeile  im  Fenster  dargestellt  werden  soil. 


VOID  handle_menu  (WINDOW?  window,  WORD  title,  WORD  item); 

Die  Funktion  wird  in  die  Komponente  „hndl_menu“  der  Fensterstruktur  eingehangt, 
wenn  eine  Meniizeile  im  Fenster  dargestellt  werden  soil. 


VOID  box  (WINDOW?  window,  BOOLEAN  grow); 

Die  Funktion  zeichnet  eine  sich  ausdehnende  oder  zu.sammenziehende  Box.  Sie  wird  von 
den  Funktionen  „wi_open“  und  „wi__close“  aufgerufen. 

window  : Zeiger  auf  das  Fenster,  an  welchem  die  Box  enden  soli  bzw.  von  welchem 
die  Box  ausgehen  soli 

grow  : TRUE,  wenn  eine  sich  vergroBernde  Box  gezeichnet  werden  soli,  FALSE, 
wenn  eine  sich  zusammenziehende  Box  gezeichnet  werden  soil 

Die  Funktion  besorgt  sich  zunachst  das  kleine  Rechteck,  welches  aus  einem  Icon  oder 
einem  Menii  kommen  kann.  Dann  wird  der  Rand  des  Fensters  berechnet  und  schlieBlich 
die  Growbox  oder  Shrinkbox  gezeichnet.  Falls  es  sich  um  ein  Accessory  handelt,  wird 
keine  Shrinkbox  gezeichnet,  da  die  Meldung  AC_CLOSE  an  einer  strategisch  ungiinsti- 
gen  Stelle  an  das  Accessory  ergeht.  Beim  SchlieBen  der  Accessory-Fenster  wurden  dann 
Shrinkboxen  auch  im  „weiBen“  Bildschirm  erscheinen. 


BOOLEAN  wi_test  (WINDOW?  window,  WORD  action); 

Die  Funktion  wird  in  die  Komponente  „test“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  ein  Fenster  geschlossen  oder  geldscht  werden 
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soil  (DO_CLOSE  bzw.  DO_DELETE).  Ansonsten  wird  die  Funktion  vom  globalen 
Menii-Manager  aufgerufen,  wenn  getestet  werden  soil,  ob  die  Cut/Copy/Paste- 
Meniipunkte  ausfiihrbar  sind  oder  nicht.  1st  dies  der  Fall,  so  muB  die  Funktion  TRUE 
zuriickliefern,  FALSE  sonst. 

Wird  die  Funktion  nicht  eingehangt,  so  geht  man  davon  aus,  daB  es  keine  Cut/Copy/ 
Paste-Funktionalitat  gibt. 


VOID  wi_open  (WINDOWP  window); 

Die  Funktion  wird  in  die  Komponente  „open“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  bevor  das  Fenster  geoffnet  wird.  An  dieser  Stelle 
kann  z.B.  ein  sich  ausdehnendes  Rechteck  gezeichnet  werden. 


VOID  wi_close  (WINDOWP  window); 

Die  Funktion  wird  in  die  Kompwnente  „close“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  nachdem  das  Fenster  geschlossen  wurde.  An  dieser 
Stelle  kann  z.B.  ein  sich  zusammenziehendes  Rechteck  gezeichnet  werden. 


VOID  wi_delete  (WINDOWP  window); 

Die  Funktion  wird  in  die  Komponente  „delete“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  bevor  das  Fenster  geloscht  wird.  An  dieser  Stelle 
kann  z.B.  der  Fensterinhalt  gerettet  werden. 


VOID  wi  draw  (WINDOWP  window); 

Die  Funktion  wird  in  die  Komponente  „draw“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  der  Fensterinhalt  gezeichnet  wird.  Das  aktuelle 
Clipping-Rechteck  ist  bereits  gesetzt. 


VOID  wi_arrow  (WINDOWP  window,  WORD  dir,  LONG  oldpos,  LONG  newpos); 

Die  Funktion  wird  in  die  Komponente  „arrow“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  der  Fensterinhalt  gescrollt  werden  soli. 

Zunachst  hat  das  Fenster  die  Moglichkeit,  auf  die  Parameter  zu  reagieren.  So  kann  es 
z.B.  weitere  Textzeilen  eines  Dokumentes  anfordem  oder  im  Datenbestand  vorriicken. 
Dann  werden  die  neue  Position  im  Dokument  festgelegt,  die  Schieber  gesetzt  und  das  ei- 
gentliche  Scrolling  durchgefiihrt. 
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VOID  wi_snap  (WINDOW?  window,  RECT  *new,  WORD  mode); 


Die  Funktion  wird  in  die  Komponente  „snap“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  das  Fenster  bewegt  oder  in  seiner  GroRe  veran- 
dert  wurde. 


Zunachst  wird  die  Differcnz  zur  vorigen  Position  bestimmt.  Dann  wird  entschieden,  wel- 
che  Komponenten  des  Fensters  einrasten  sollen  (X-,  Y-Position,  Breite,  Hohc).  Beim 
Vergrdliern  oder  Verkleinern  konnen  auRerdem  spezielle  Algorithmen  ausgefiihrt  wer- 
den.  So  ist  es  gunstig,  beim  VergroBern  eines  Fensters  unter  den  unteren  Rand  eines  Do- 
kumentes  neue  Information  von  weitcr  oben  zu  holen  und  das  untere  Ende  exakt  darzu- 
stellen,  d.h.  das  untere  Ende  des  Fensters  mit  dem  unteren  Ende  des  Dokumentes  abzu- 
gleichen. 


VOID  wi_objop  (WINDOW?  window,  SET  objs,  WORD  action); 


Die  Funktion  wird  in  die  Komponente  „objop“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Menu-Manager  aufgerufen,  wenn  die  Funktionen  „Offnen“,  „Info“  und  „Hilfe“  ge- 
wahlt  werden,  wobei  gleichzeitig  ein  oder  mehrere  Objekte  selektiert  waren. 


WORD  wi_drag  (WINDOW?  src_window,  WORD  src_obj, 

WINDOW?  dest_ window,  WORD  dest_obj); 


Die  Funktion  wird  in  die  Komponente  „drag“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  die  Applikation  bekanntgibt,  dal)  ein  Objekt 
von  einem  Fenster  in  ein  anderes  geschoben  wurde. 


VOID  wi_click  (WINDOW?  window,  MKINFO  *mk); 

Die  Funktion  wird  in  die  Komponente  „click“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  in  das  Fenster  geklickt  wurde. 


VOID  wi  unclick  (WINDOW?  window); 


Die  Funktion  wird  in  die  Komponente  „uncUck“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  um  ein  Fenster  zu  deselektieren,  wenn  in  ein  anderes 
geklickt  wurde. 
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BOOLEAN  wi_key  (WINDOW?  window,  MKINFO  *mk); 

Die  Funktion  wird  in  die  Komponente  „key“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  eine  Taste  gedriickt  wurde.  Handelte  es  sich 
urn  eine  Taste  fiir  das  Menii,  welches  in  das  Fenster  eingehangt  werden  kann,  so  mull 
nach  dem  Ausfiihren  des  Menus  die  Funktion  sofort  beendet  werden. 


VOID  wi_timer  (WINDOW?  window); 

Die  Funktion  wird  in  die  Komponente  „timer“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  eine  bestimmte  Zeit  fur  ein  Fenster  abgelaufen 
ist.  Das  Fenster  darf  dann  eine  Aktion  durchfuhren. 


VOID  wi_top  (WINDOW?  window); 

Die  Funktion  wird  in  die  Komponente  „top“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  das  Fenster  nach  oben  kommt. 


VOID  wi_untop  (WINDOW?  window); 

Die  Funktion  wird  in  die  Komponente  „untop“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Window-Manager  aufgerufen,  wenn  das  Fenster  nach  unten  kommt. 


VOID  wi_edit  (WINDOW?  window,  WORD  action); 

Die  Funktion  wird  in  die  Komponente  „edit“  der  Fensterstruktur  eingehangt.  Sie  wird 
vom  Menu-Manager  aufgerufen,  wenn  einer  der  Meniipunkte  Undo,  Cut,  Copy,  Faste, 
Clear  oder  Select  all  aufgerufen  wird. 


6.6  Bedienung  von  SCRAP 


Wenn  alle  Module  iibersetzt  und  gelinkt  wurden,  so  ensteht  ein  Frogramm  mit  Namen 
SCRAF.PRG  (GEMDOS),  SCRAP.  A??  (MS-DOS)  oder  SCRAF.286  (FlexOS).  Dieses 
kann  durch  Doppelklick  vom  Desktop  aus  gestartet  werden. 

Zunachst  wird  der  Desktop  dargestellt,  dann  dffnet  sich  auch  das  Klemmbrettfenster. 
Falls  sich  Dateien  im  Verzeichnis  des  GEM-Klemmbretts  befmden,  werden  diese  als  Pik- 
togramme  angezeigt.  Falls  sich  keine  Dateien  dort  befinden,  sollten  Sie  wenigstens  eine 
Text-Datei  dort  hineinkopieren,  damit  Sie  mit  dem  Programm  richtig  arbeiten  konnen. 
Nennen  Sie  die  Datei  z.B.  SCRAP.TXT. 
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489 


Die  Dateien  im  Klemmbrettfenster  konnen  geoffnet  und  damit  angezeigt  werden.  Dies 
geschieht  in  der  gewohnten  Weise,  d.h.  durch  Doppelklick  oder  Einfachklick  und  nach- 
folgendem  Offnen  iiber  den  entsprechenden  Meniipunkt.  Auf  die  gleiche  Weise  konnen 
auch  mehrere  Objekte  selektiert  und  geoffnet  werden.  Fiir  die  Objekte  im  Desktop  gilt 
dies  analog. 

Bestimmte  einzelne  Meniipunkte  konnen  wahl weise  auch  iiber  die  Funktionstasten  ange- 
wiihlt  werden.  Im  Klemmbrettfenster  befindet  sich  auch  eine  Menuzeile,  die  angeklickt 
werden  kann.  Dann  klappt  das  jeweilige  Menii  herunter.  Aus  diesem  konnen  nun  eben- 
falls  Meniipunkte  ausgewahlt  werden.  Dazu  muB  der  Mausknopf  entweder  gedriickt  oder 
losgelassen  werden,  je  nachdem,  ob  das  Menii  mit  gedruckt  gehaltenem  Mauskopf  ange- 
wahlt  wurde  oder  nicht.  Das  Menii  „Anzeigen“  im  Klemmbrett  bietet  die  Mdglichkeit, 
aus  verschiedenen  Masken  auszuwahlen,  so  daB  nur  ein  Teil  der  Dateien  im  Klemmbrett 
angezeigt  werden  kann. 

Die  Menupunkte  „Ausschneiden“,  „Kopieren“  und  „Einfiigen“  des  Meniis  „Bearbeiten“ 
konnen  nur  dann  auf  die  Objekte  des  Klemmbrettfensters  angewendet  werden,  wenn  der 
Schalter  „Auf  GEM'Klemmbrett"  eingeschaltet  ist.  Sie  haben  dann  folgende  Bedeutung: 

Ausschneiden:  Das  Original  wird  geldscht,  aber  eine  Kopie  davon  auf  das  Klemmbrett 
abgelegt.  Dies  entsprichteinem  Umbenennen.  HeiBt  das  Original  „TEST.TXT“,  so  wird 
also  zunachst  ein  eventuell  vorhandenes  „SCRAP.TXT“  geldscht,  dann  „TEST.TXT“ 
in  „SCRAP.TXT“  umbenannt.  Dies  bedeutet,  daB  danach  immer  eine  Datei  mit  demsel- 
ben  Suffix  wie  das  Original  existiert,  jedoch  das  Prafix  SCRAP  hat. 

Kopieren:  Wie  Ausschneiden,  wobei  das  Original  erhalten  bleibt.  Es  existieren  also  dann 
zwei  identische  Dateien,  z.B.  „TEST.TXT“  und  „SCRAP.TXT“. 

Einfiigen:  Hier  nicht  implementiert. 

Der  Meniipunkt  „Ldschen“  ist  aktiv,  wenn  mindestens  ein  Objekt  im  Klemmbrettfenster 
angewahlt  ist,  „Alles  auswahlen"  ist  immer  aktiv,  wenn  mindestens  ein  Objekt  im 
Klemmbrettfenster  existiert. 

Diebeiden  Menupunkte  „Power“  und  „Grafik“  offnen  jeweils  bis  zu  sieben  Fenster  der 
entsprechenden  Sorte.  Die  Fenster  „Power“  zeigen  die  Potenzen  einer  Zahl.  Auf  eine 
neue  Potenz  kann  umgeschaltet  werden,  wenn  eine  Zahl  zwischen  zwei  und  neun  eingege- 
ben  wird,  wahrend  das  Fenster  an  oberster  Stelle  liegt.  Die  zweite  Mdglichkeit  wird  durch 
ein  Pop-Up-Menii  gegeben,  welches  an  der  Stelle  des  Mauszeigers  erscheint,  wenn  in  das 
Fenster  geklickt  wird.  Dann  kann  aus  diesem  die  Potenz  ausgewahlt  werden.  Das  Fenster 
demonstriert  auBerdem  eine  eigene  Mausform,  die  beim  Eintreten  in  das  Fenster  er- 
scheint. 

Die  Grafikfenster  demonstrieren  den  Gebrauch  verschiedener  Fiillmuster.  Die  Fiillmuster 
konnen  durch  die  Tasten  ’ + ’ und  vor-  bzw.  zuriickgeschaltet  werden.  Mit  den  Fasten 
’0’  bis  ’3’  konnen  die  verschiedenen  Fiillarten  angezeigt  werden  (siehe  auch  Abb.  2.8). 
AuBerdem  fuhrt  das  Fenster  die  Benutzung  des  Timers  vor.  Jede  Sekunde  wird  auf  ein 
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neues  Fullmuster  umgeschaltet.  Wurden  mehrere  Fenster  gedffxiet  und  verschiedene  Full- 
muster  bzw.  Fiillarten  ausgewahlt,  so  ergibt  sich  der  Effekt  eines  Multitasking-Systems. 
Die  Benutzung  des  Timers  kann  fiir  jedes  Fenster  durch  die  Taste  unterbrochen  und 
wieder  fortgesetzt  werden. 

Der  Menupunkt  „Einsteliungen“  im  Menii  „Optionen“  dcmonstriert  sowohl  bcnutzerde- 
finierte  Objekte  (ankreuzbare  Kndpfe)  als  auch  die  Implementierung  einer  Hilfe-Box. 

Das  Programm  kann  auch  als  Accessory  gestartet  werden  (nur  Atari  ST),  wenn  es  in 
SCRAP.  ACC  umbenannt  und  auf  das  Bootlaufwerk  kopiert  wird.  Beira  Offnen  des  Ac- 
cessories wird  nun  zuniichst  der  Desktop  in  einem  echten  Fenster  gezeigt.  In  ihm  bcfindet 
sich  auch  die  globale  Meniizeile.  Zum  Offnen  des  Klemmbretts  muB  nun  noch  ein  Dop- 
pelklick  auf  das  Klemmbrettsymbol  getatigt  werden.  Ansonsten  wird  das  Accessory  wie 
die  Applikation  bedient. 

Das  Demoprogramm  enthiilt  natiirlich  viele  Dinge,  die  nur  der  Demonstration  dienen. 
Wenn  auch  Sie  das  Gefiihl  haben,  daft  es  intuitiv  zu  bedienen  ist,  so  nehmen  Sie  sich  an 
ihm  ein  Beispiel  und  programmieren  Ihre  Applikationen  mit  Hilfe  unserer  Routinen.  Al- 
lein  schon  die  ahnliche  Mcnugestaltung  wird  dem  Benutzer  eine  groBe  Hilfe  sein,  so  daB 
er  nicht  immer  wieder  umdenken  muB. 
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Anhang  A.  Header-Dateien 

Header-Date!  PORTAB.H: 


***»**»****»*»»»*******»«*»*»»»*******»*»***»*»***»***»*»»»»»»»*»»»»»#**)(»***»/ 


/*  */ 

/*  PORTAB.H  */ 

/*  */ 

/*  Use  of  this  file  may  make  your  code  compatible  with  all  C compilers  */ 

/*  listed.  */ 

/*  */ 


/**»******^Hf*******)HHHHt#***jH****)t****»^t}e*»»»»»)Ht)He»***)(»»»********)Ht»»»»*»»»*/ 

/*  ENVIRONMENT  */ 

/**»******^HHHt*»»****»^HHf***»»*»»*)t****)Ht»X*»*»»»*)t*»»»»»»*****##*«»»»»»»*»»»»/ 


#ifndef 

..PORTAB.. 

# define 

__P0RTAB__ 

# define 

GEMDOS 

1 

/*  Digital  Research  GEMDOS 

*/ 

define 

MSDOS 

0 

/*  Microsoft  MSDOS 

# define 

0S2 

0 

/*  Microsoft  OS/2 

*/ 

# define 

FLEXOS 

0 

/*  Digital  Research  FlexOS 

# define 

M68000 

1 

/*  Motorola  Processing  Unit 

*/ 

# define 

18086 

0 

/*  Intel  Processing  Unit 

# define 

DR_C 

0 

/*  Digital  Research  C Compiler 

*/ 

# define 

LASER_C 

0 

/*  Laser  C Compiler 

*/ 

# define 

LATTICE_C 

0 

/*  Lattice  C Compiler 

*/ 

# define 

MW_C 

0 

/*  Mark  Williams  C Compiler 

*/ 

# define 

TURBO_C 

1 

/*  Turbo  C Compiler 

*/ 

# define 

MS_C 

0 

/*  Microsoft  C Compiler 

*/ 

#define 

HIGH_C 

0 

/*  Metaware  High  C Compiler 

*/ 
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# define  GEMl 

0x0001 

# define  GEM2 

0x0002 

# define  GEM3 

0x0004 

# define  XGEM 

0x0100 

#lfndef  GEM 
#if  GEMDOS 
# define  GEM 

GEMl 

#endif  /*  GEMDOS  */ 

#if  MSDOS 
# define  GEM 
#endif  /»  MSDOS  */ 

GEM3 

#if  0S2 
# define  GEM 
#endif  /*  MSDOS  »/ 

XGEM 

#if  FLEXOS 
# define  GEM 

XGEM 

#endif  /*  FLEXOS  »/ 

#endif  /*  GEM  */ 

/»  ATARI  GEM  version  ^ 

/*  MSDOS  GEM  2.x  versions  * 

/»  MSDOS  GEM/3  version 
/*  OS/2,FlexOS  X/GEM  version  * 


/*  GEMDOS  default  is  GEMl  * 
/*  MSDOS  default  is  GEM3  * 
/*  OS/2  default  is  X/GEM  * 
/*  FlexOS  default  is  X/GEM  * 


/»*»***»*»»*********#*»»»*****»«*********»*)HHHHHHt****»»*#*»»***»»«#«**»4HHt***, 

/*  STANDARD  TYPE  DEFINITIONS 


# define 

BYTE 

char 

# define 

UBYTE 

unsigned 

char 

#if  LATTICE.C 

# define 

WORD 

short 

# define 
#else 

UWORD 

unsigned 

short 

# define 

WORD 

int 

# define 
#endif 

UWORD 

unsigned 

int 

# define 

LONG 

long 

# define 

ULONG 

unsigned 

long 

# define 

BOOLEAN  WORD 

# define 

FLOAT 

float 

# define 

DOUBLE 

double 

/*  Signed  byte  * 

/*  Unsigned  byte  * 

/*  Signed  word  (16  bits)  * 

/*  unsigned  word  * 

/*  Signed  word  (16  bits)  * 

/*  unsigned  word  * 

/*  signed  long  (32  bits)  * 

/*  Unsigned  long  * 

/*  2 valued  (true/false)  * 

/*  single  precision  float  * 

/*  double  precision  float  * 


Header-Datei  PORTAB.H: 
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# define 

INT 

int 

/» 

a machine  dependent  int 

V 

# define 

UINT 

unsigned  int 

/» 

a machine  dependent  uint 

*/ 

# define 

REG 

register 

/» 

register  variable 

V 

# define 

AUTO 

auto 

/* 

Local  to  function 

*/ 

# define 

EXTERN 

extern 

/* 

External  variable 

*/ 

# define 

LOCAL 

static 

/* 

Local  to  module 

*/ 

# define 

MLOCAL 

LOCAL 

/* 

Local  to  module 

*/ 

# define 

GLOBAL 

/* 

Global  variable 

*/ 

/**«*«»»*»»*»»***»»»»*»**»»«««»»»*»»***#*»«»««**»»»*»*»*»*»»»*»*****»**»»*«*»/ 
/*  COMPILER  DEPENDENT  DEFINITIONS  */ 

/»»*»«*»»*»***»»*»»*»»»»»»»*»*«»*»»*»» 


#if  GEMDOS 

/* 

GEMDOS  compilers 

*/ 

#if  DR_C 

# define  void  WORD 

/* 

DR^C  doesn't  know  void 

»/ 

#endlf  /»  DR_C  */ 

#if  LASER.C 

# define  graf_mbox  graf_movebox 

/* 

Wrong  GEM 

binding 

»/ 

# define  graf_rubbox  graf_rubberbox 
# end if  /*  LASER_C  */ 

/* 

Wrong  GEM 

binding 

*/ 

#if  LATTICE.C 

# define  graf_mbox  graf_raovebox 

/* 

Wrong  GEM 

binding 

*/ 

# define  graf_rubbox  graf_rubberbox 
#endif  /»  UTTICE_C  */ 

/* 

Wrong  GEM 

binding 

*/ 

#if  TURBO.C 

# define  graf_rabox  graf_movebox 

/» 

Wrong  GEM 

binding 

»/ 

# define  graf_rubbox  graf_rubberbox 

/* 

Wrong  GEM 

binding 

*/ 

#endif  /*  TURBO_C  »/ 

#lf  MW_C 

#define  VOID  WORD  /*  MW_C  doesn't  know  (void  »)  */ 

*endif  /*  MW.C  */ 

#if  LATTICE.C 

#define  ADR(A)  (LONG)A  » 16,  (LONG)A  & OxFFFF 
#else 

#define  ADR(A)  (WORD) ( (LONG) A » 16),  (WORD) ( (LONG) A & OxFFFF) 

#endif  /»  LATTICE.C  »/ 

#endif  /*  GEMDOS  */ 
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#if  MSDOS  1 0S2  /*  MSDOS  or  0S2  compilers  * 

#define  ADR(A)  (WORD) ( (LONG) A & OxFFFF) , (WORD) ( (LONG) A » 16) 

#endif  /*  MSDOS  »/ 

#if  FLEXOS  /*  FlexOS  compilers  * 

#define  ADR(A)  (WORD) ( (LONG) A & OxFFFF),  (WORD) ((LONG) A » 16) 

#endif  /*  FLEXOS  */ 

#if  MS_.C  ! TURBO.C  1 HIGH.C  /*  ANSI  compilers  * 

# define  ANSI  1 

# define  .(params)  params  /*  parameter  checking  * 

#else 

# define  ANSI  0 

# define  _( params)  ()  /*  no  parameter  checking  * 

# define  const 
# define  volatile 
# define  size_t  UINT 
#endlf 


#if  DR_C  ! LASER.C  I LATTICE.C  ! MW.C  ! HIGH.C 
♦define  cdecl 
♦define  pascal 

♦ endif 

♦define  CONST  const 

♦define  VOLATILE  volatile 

♦define  CDECL  cdecl 

♦define  PASCAL  pascal 

♦define  SIZE.T  size.t 

♦ ifndef  VOID 
♦define  VOID  void 
♦endif 


/******1HHHHHHf»»»******)HHHHHHHt#»»»*)HHt»)HHHt*)t****jHHHt»********»»*****»»***»»*, 
/*  OPERATING  SYSTEM  DEPENDENT  DEFINITIONS  *, 

/**»*^HHHHHHf*#*********»»**«**»«»»********«*»)Ht»**5fX»*X**»*»**jHf***»»*#*»»»*»»^ 


♦ if  GEMDOS 

♦ define  FAR 
♦define  NEAR 

♦ else 

♦define  FAR  far 

♦define  NEAR  near 

♦endif  /*  GEMDOS  */ 


/*  Far  Pointer  * 

/*  Near  Pointer  * 

/*  Far  Pointer  * 

/*  Near  Pointer  * 
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#if  GEM  & GEMl 

# define  appl_bvset(bvdlsk,  bvhard) 

#define  appl.yield()  evnt_timer  (O,  O) 

# define  memi_unregister(mid) 

# define  scrp_clear() 

#define  xgrf_stepcalc(orgw,  orgh,  xc,  yc,  w,  h,  pcx,  pcy,  pent,  pxstep,  pystep) 
♦define  xgrf_2box(xc,  yc,  w,  h,  corners,  ent,  xstep,  ystep,  doubled) 

♦endif  /*  GEMl  */ 

♦if  GEM  & (GEMl  ! XGEM) 

♦define  shel_rdef (ipcmd,  Ipdir) 

♦define  she l_wdef( Ipcmd,  Ipdir) 

♦endif  /»  GEMl  ! XGEM  */ 

♦if  GEM  & (GEMl  ! GEM2) 

♦define  menu_click(cllck,  setlt) 

♦endif  /*  GEMl  ! GEM2  */ 

♦if  GEM  & (GEM2  ! GEM3  ! XGEM) 

♦define  fsel_exinput(pipath,  plsel,  pbutton,  plabel)\ 
fsel_lnput  (pipath,  pisel,  pbutton) 

♦ define  wlnd_nevr() 

♦endif  /»  GEM2  ! GEM3  1 XGEM  */ 


/*  MISCELLANEOUS  DEFINITIONS  »/ 


♦ define 

FALSE 

(BOOLEAN) 0 

/* 

♦ define 

TRUE 

(BOOLEAN) 1 

/* 

♦ define 

FAILURE  (-1) 

/* 

♦ define 

SUCCESS 

0 

/* 

♦ define 

FOREVER 

for  (;;) 

/* 

♦ define 

EOS 

•\0' 

/* 

♦ ifndef 

NULL 

♦ define 

NULL 

OL 

/* 

♦ endif 

♦ ifndef 

EOF 

♦ define 

EOF 

(-1) 

/* 

♦endif 

Function  FALSE  value 
Function  TRUE  value 
Function  failure  return  val 
Function  success  return  val 
Infinite  loop  declaration 
End  of  string  value 


Null  long  value 


EOF  value 


♦/ 

V 
»/ 
*/ 

V 
»/ 


*/ 


*/ 


♦endif  /*  __P0RTAB__  »/ 


‘((qq.Su3tq.  OUOft  ‘asjjnqq.*  hVJ  QIOA))” 
f((3IBosq.  QHOrt  ‘q.^3uaiq.  OHOW  ‘-lajJTiqq.#  avd  aiOA))‘ 

r((0HiBudK  HVa  31M))" 
f((j:jnqd*  avi  aiOA  ‘qq.3uaT  QHOW  QHOfl))' 

f((jjnqd»  HVi  QIOA  ‘U^Suai  qhom  ‘PT«J  OHOft))” 

U(aiOA))- 


paooajq.“x<J<is 

aaort 

^ldq.“iddB 

QHOW 

puTj"xddB 

aaow 

aqf 

GHOW 

P'Bsa'X'idB 

GHOW 

qiui"iddB 

GHOW 

»«»»»***»»»*»***#»»**»*****»»»»»******»»***»»»»*»*  itJB>iq7i  uofqBOfTddv  »*»*»*/ 


/*  SOOWaO  */  JTPUS# 
/«  O'OSHfU  */  JTPUS# 

fJtra-iBdiiisO'  MiaHVdWaa  uas^xa 

SMiaHVdwao  [ 

^[8^T]  qnojppB#  yvj  OIOA 
J[8ei]  «wp«*  avi  aiOA 
USZT]  3-nosq.d  OHOW 
3.noq.ut  oaow 
f[82T]  ursQ.d  aaott 
JC821:]  uTaut  craow 
J[08]  IBqoiS  aaow 
5[TT]  IJq.uoo  aaow 

] 

5.onaq.s  jepedi?q 

o“oaffiu  JT# 

S00K30  JT# 


**»*»«*»***»*»»#**»*«»*«*»*»*#»***»»*»»»***»»»»»»****»**»***  sureaBdwao  ******/ 


'“sav'“  suTjsp# 
"sav'"  J9PUJT# 


««****»*«»*«»*»»»*»«*««»»»«»**»»««**«*»****»»»»****»»*«*****»»»»»»»*****»»***/ 


* »/ 

» SST30  uagjsnf  ^ Jaq.8ia  ;sJoqqnv  */ 


* */ 
*«»»*««*»«***»»****»*****»**»***»«**»»»*******»»***»****»*»*»»##»»*»*********/ 
* ■ S3Jn^.0Tu:q.s  pUB  suoi^-pupjap  gav  uouicuoo  :H'S3V  */ 


**»»**«#»*»«**»»»»»***««»»**»*»»»»»*«««««»****»»*»««*»***«****#*»»»**#**»*»**/ 


:H*S3V  i3|Ba-J»P®*H 


U3t3W(J-J3p09fi  'y  SUDtfUy 


96t 
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#if  GEM  & (GEM2  1 GEM3  I XGEM) 

WORD  appl.bvset  _((UWORD  bvdisk,  UWOEU3  bvhard)); 

VOID  appl_yield  _((VOID)); 

#endif  /*  GEM2  1 GEM3  ! XGEM  */ 


WORD  appl_exlt  _((VOID)); 


/»»**»»  Event  library  **»**»*»*»»»«»»****»»*»»»»»»*»*»»»»»»»»»»****»**»*»»»»«*/ 


typedef  struct 
( 

struct  erect 

erect 

FAR  *o_link; 

WORD 

o_x; 

WORD 

o_y; 

WORD 

o_w; 

WORD 

o_h; 

) ORECT; 

typedef  struct 
f 

greet 

t 

WORD  g.x; 
WORD  g_y; 
WORD  g„w; 
WORD  g.h; 
] GRECT; 

typedef  struct 

mevent 

{ 


UWORD  e_  flags  j 
DWORD  e_bclk; 
UWORD  e_bmsk; 
UWORD  e_bst; 
UWORD  e_nilflagsj 
GRECT  e_ral; 

UWORD  e_m2flagsj 
GRECT  e_m2; 

WORD  *e_mepbuf; 
ULONG  e_tlme; 
WORD  e_mx; 

WORD  e_my; 

UWORD  e_mb; 

UWORD  e_ks; 

UWORD  e_kr; 

UWORD  e_br; 

UWORD  e_m3 flags; 
GRECT  e_m3; 
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WOEID  e_xtraO ; 
WOEID  »e_smepbuf; 
ULONG  e_xtral; 
ULONG  e_xtra2; 

) MEVENT; 

/*  multi  flags  */ 

# define  MU_KEYBD 

0x0001 

# define  MU_BUTT0N 

0x0002 

# define  MU_M1 

0x0004 

# define  MU_M2 

0x0008 

# define  MU_MESAG 

0x0010 

# define  MU.TIMER 

0x0020 

# define  MU_M3 

0x0040 

# define  MU.SYSMESAG 

0x0080 

# define  MU.POSTEV 

0x1000 

/*  keyboard  states  */ 

# define  K_RSHIFT 

0x0001 

* define  K_LSHIFT 

0x0002 

♦define  K_CTRL 

0x0004 

♦ define  K_ALT 

0x0008 

/*  message  values  */ 

♦define  SCR_MGR 

0x0001  /» 

process  id  of  the  screen  manager  #/ 

♦define  AP.MSG 

0 

♦define  HN.SELECTED 

10 

♦define  WM_REDRAW 

20 

♦define  WM_T0PPED 

21 

♦define  WM.CLOSED 

22 

♦define  WM.FULLED 

23 

♦define  WM_ ARROWED 

24 

♦define  WM_HSLID 

25 

♦define  WM^VSLID 

26 

♦ define  WfLSIEED 

27 

♦define  WM.MOVED 

28 

♦define  WM_NEWT0P 

29  /» 

for  compatibility  */ 

♦define  WM_ UNTOPPED 

30 

♦define  WM_ONTOP 

31 

♦define  WM_OFFTOP 

32 

1 

♦define  PR_FINISH 

33 
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# define  AC.OPEN 
# define  AC.CLOSE 

# define  CT.UPDATE 
# define  CT.MOVE 
# define  CT.NEWTOP 
# define  CT.SWITCH 

# define  SV_ONTOP 
# define  SV_OFFTOP 

typedef  struct 

[ 

WORD  m_out; 

WORD  nuxj 
WORD  m_y; 

WORD  m_w; 

WORD  m_h; 

] MOBLK; 

UWOEiD  evnt_keybd 
WORD  evnt_button 


WRD  evnt_mouse 


WORD  evnt_mesag 
WORD  evnt..  timer 
WORD  evnt_multi 


#if  GEM  & XGEM 
WORD  evnt_event 
#endif  /*  XGEM  */ 
WORD  evnt_dclick 


40 

41 

50 

51 

52 

53 

110 

111 


-((VOID)); 

.((WORD  clicks,  DWORD  mask,  DWORD  state, 

WORD  FAR  *pmx,  WORD  FAR  »pmy, 

WORD  FAR  »pmb,  WORD  FAR  »pkshr 
.((WORD  flags,  WORD  x,  WORD  y,  WORD  width,  WORD  height, 
WORD  FAR  *pmx,  WORD  FAR  *pmy, 

WORD  FAR  *pmb,  WORD  FAR  *pks)); 

.((WORD  FAR  Xpbuff)); 

.((DWORD  locnt,  DWORD  hicnt)); 

.((DWORD  flags,  DWORD  belk,  DWORD  bmsk,  DWORD  bst, 
DWORD  mlflags, 

DWORD  mix,  DWORD  raly,  DWORD  mlw,  DWORD  ralh, 

DWORD  ra2flags, 

DWORD  m2x,  DWORD  m2y,  DWORD  m2w,  DWORD  ra2h, 

WORD  FAR  *mepbuff,  DWORD  tic,  DWORD  the, 

WORD  FAR  *pmx,  WORD  FAR  »pmy,  WORD  FAR  *pmb, 

WORD  FAR  *pks,  DWORD  FAR  »pkr,  WORD  FAR  *pbr)); 


.( (MEVENT  *praevent) ) ; 
.((WORD  rate,  WORD  setit)); 


q.^3f9^“qo•[pT] 
^q.p^-rt-qO•  [Pt] 

^“QO’CPT]  99*I4 
X~qO’[pT] 
oads'qo' [pp]  aoj.% 
3q.^ps”qo‘ [pp]  ssjp 
sSBij“qo'[pp]  aaaq 
(9  « advfp-qo  • [pp  ] asjq.) 
(jjxQ  ? 8d^p-qo-[pp]  aajp) 
ppBp-qo-[pp]  88 jp 
pB8q"qo'[pp]  88 jp 
pxsu^qo • [pp ] 88 jp 


(pp  '88J:p)lH0iaH‘a0  supjsp# 

(pp  ‘88jp)Hxairt'ao  9UPJ8P# 

(pp  ‘88jp)x"ao  aupjsp# 
(PP  ‘88Jp)x"ao  aupjap# 
(pp  '88Jp)oadg“ao  8UPJ8P# 
(pp  ‘88jp}axvis"ao  9upj8p# 

(PP  ‘asap^sovii'ao  SUTJSP# 

(pp  ‘88ap)adxxxa"ao  aupjap# 
(pp  '88:rp}aaxx“ao  sufjsp# 
(pp  '88J;p)llvX“ao  9UTJ9P* 
(pp  '88«ip)avaH“ao  aupjsp# 
(PP  '88jp)xxaN'ao  9UIJ9P# 


’»«»»»*»»»*»**»*****»**»»*»*»»»»»**»»**»»»»«*»*»««*»****  4-iB-iqTT  0-08  Cqo  »**»*«/ 


/*  K30X  1 Cwao  */  JTPua# 

‘((PPP8S  OHOft  '2fOTI°  aaort))”  :ilopTO-nu8Ui  OHOn 

(K30X  ; CK30)  ? W30  JT* 


/»  waox  I ^Hao  i c:wao  */  jppua# 
J((PTin  OHOrt))”  a8psp§8aun“nu8ui  oaoft 
(H30X  1 CK30  I 2W30)  ^ W30  JT* 


'((apsd*  Hva  axxa  ‘pxd  OHOrt))' 
f((px8pd*  avj  axxa  ‘fiTtui  aaon  ava  xoarao))” 

{((pppBuiJou  OHOft  'uinuapppp  OHOft  HVi  103X30) )“ 

J((pp8iqBU8  OHOft  ‘lunuiuepp  oaoft  ‘aa-iP*  HVi  XOaxaO))” 
^((pp3^o^qo  OHOft  'umutuapp  OHOft  ‘ssjp*  HVi  XOaraO)r 
f((ppwoqg  oaOM  ‘aajq-5*  HVJ  XOaxao))" 


aaq.st3aj:"nuaui 

QHOft 

^xs!^“uuaui 

OHOft 

XBUJJOU!^.“nUSUI 

OHOft 

OHOft 

:i{oaiioT“nuaui 

OHOft 

aBq“nuaui 

OHOft 

’**»*»*»*»****»*»**»*««»*«»»»*»**»«»»*«***»***********»***  toJqpi  nu8M  *****^(/ 


fxoarao  [ 


/* 

poafqo  JO  pqSpaq 

*/ 

fpqSpsipqo 

OHOft 

/» 

poafqo  JO  qpppM 

*/ 

fqpppwqo 

OHOft 

/* 

poafqo  JO  J8UJOO  pjep  aaddn 

»/ 

Jj?*qo 

OHOft 

/* 

poafqo  JO  J8UJOO  pjap  asddn 

*/ 

fx~qo 

OHOft 

/* 

8ST8  BupqpjtuB  <-  -„pno„ 

*/ 

foads"qo 

ONOO 

/* 

•••  'oassoHO  ‘oaxoaoas  -spsps 

»/ 

f apapB'qo 

OHOftn 

/« 

sSbij 

*/ 

' sSapj-qo 

OHOftn 

/* 

'HVHO  ‘xoa  -posfqo  jo  adj?p 

*/ 

fed^p'qo 

OHOwn 

/» 

UBjpppqo  s, poafqo  jo  ppap  <- 

*/ 

fppap-qo 

OHOft 

/« 

uajpipqo  s, poafqo  jo  psaq  <- 

»/ 

fpaaq'qo 

OHOft 

/* 

Suppqps  pxau  s, poafqo  <- 

»/ 

f pxau^qo 

OHOft 

] 

poaTqo  poruips  jspadvtp 


'**«»*»»**»«******»»»»»**»»»******»**»»»»»***#»*****»»  ajnponjps  poafqo  »#»»»»/ 


u3pjvQ-J3pTJ3f{  y Stan/tty 


OOS 
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# define 

ROOT 

0 

# define 

NIL 

-1 

/* 

nil  object  index  */ 

# define 

MAX_LEN 

81 

/* 

max  string  length  */ 

# define 

MAILDEPTH 

8 

/* 

max  depth  of  search  or  draw  for  objects  */ 

# define 

IP.HOLLOW 

0 

/* 

inside  patterns  */ 

# define 

IP_1PATT 

1 

# define 

IP_2PATT 

2 

# define 

IP_3PATT 

3 

# define 

IP_4PATT 

4 

# define 

IP_5PATT 

5 

# define 

IP_6PATT 

6 

# define 

IP.SOLID 

7 

/» 

system  foreground  and 

*/ 

/* 

background  rules 

*/ 

# define 

SYS.FG 

0x1100 

/* 

but  transparent 

V 

# define 

WTS.FG 

Oxllal 

/* 

window  title  selected 

*/ 

/* 

using  pattern  2 & 

*/ 

/* 

replace  mode  text 

*/ 

# define 

WTN.FG 

0x1100 

/* 

window  title  normal 

*/ 

# define 

IBM 

3 

/* 

font  types  */ 

# define 

SMALL 

5 

# define 

G.BOX 

20 

/* 

graphic  types  of  obs 

# define 

G.TEXT 

21 

# define 

G_BOXTEXT 

22 

# define 

G_  IMAGE 

23 

# define 

G„USERDEF 

24 

# define 

G_PROGDEF 

24 

/* 

for  compatibility  */ 

# define 

G.IBOX 

25 

# define 

G_BUTTON 

26 

♦define 

G_BOXCHAR 

27 

♦define 

G_STRING 

28 

♦define 

G.FTEXT 

29 

♦define 

G.FBOXTEXT 

30 

♦ define 

G_ICON 

31 

♦ define 

G_TITLE 

32 

♦ define 

NONE 

0x0000 

/* 

Object  flags  */ 

♦ define 

SELECTABLE 

0x0001 

♦ define 

DEFAULT 

0x0002 

♦ define 

EXIT 

0x0004 

♦ define 

EDITABLE 

0x0008 

♦ define 

RBUTTON 

0x0010 
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# define 

LASTOB 

0x0020 

# define 

TOUCHEXIT 

0x0040 

# define 

HIDETREE 

0x0080 

# define 

INDIRECT 

0x0100 

# define 

NORMAL 

0x0000  /*  Object  states  »/ 

# define 

SELECTED 

0x0001 

# define 

CROSSED 

0x0002 

# define 

CHECKED 

0x0004 

# define 

DISABLED 

0x0008 

# define 

OUTLINED 

0x0010 

# define 

SHADOWED 

0x0020 

# define 

WHITEBAK 

0x0040 

# define 

DRAW3D 

0x0080 

#lfndef 
# define 

WHITE 

WHITE 

0 

# define 

BLACK 

1 

# define 

RED 

2 

# define 

GREEN 

3 

# define 

BLUE 

4 

# define 

CYAN 

5 

#def ine 

YELLOW 

6 

#define 

MAGENTA 

7 

#deflne 

DWHITE 

8 

# define 

DBLACK 

9 

# define 

DRED 

10 

# define 

DGREEN 

11 

♦ define 

DBLUE 

12 

# define 

DCYAN 

13 

♦ define 

DYELLOW 

14 

♦ define 

DMAGENTA 

15 

♦endif 

♦define 

EDSTART 

0 

♦define 

EDINIT 

1 

♦define 

EDCHAR 

2 

♦define 

EDEND 

3 

♦ define 

TE.LEFT 

0 

♦ define 

TE_RIGHT 

1 

♦ define 

TE.CNTR 

2 

■* 

» 

* 
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typedef  struct  text^edinfo 


BYTE  FAR  *te_ptext;  /* 

BYTE  FAR  *te_ptmplt;  /* 

BYTE  FAR  *te_pvalld;  /* 

WORD  te.fontj  /* 

WORD  te.junkl;  /* 

WORD  te.just;  /* 

WORD  te.color;  /* 

WORD  te_juixk2;  /* 

WORD  te_thicknessj  /* 

WORD  te.txtlen;  /* 

WORD  te.tmplen;  /* 

j TEDINFO; 


ptr  to  text  (must  be  1st)  */ 
ptr  to  template  */ 
ptr  to  validation  chrs.  */ 
font  */ 
junk  word  */ 
justification-  left,  right...  */ 
color  information  word  */ 
junk  word  */ 
border  thickness  */ 
length  of  text  string  */ 
length  of  template  string  */ 


typedef  struct  icon_block 

I 


WORD 

FAR  »ib_pmask; 

/* 

WORD 

FAR  *ib.pdata; 

/* 

BYTE 

FAR  *lb_ptext; 

/* 

WORD 

ib_char; 

/* 

WORD 

ib_xchar; 

/* 

WORD 

ib.ychar; 

/* 

WORD 

lb_xicon; 

/» 

WORD 

lb_yicon; 

/* 

WORD 

lb_wicon ; 

/* 

WORD 

lb _h icon; 

/* 

WORD 

ib_xtext; 

/» 

WORD 

ib_ytext ; 

/* 

WORD 

ib.wtext ; 

/» 

WORD 

ib_htext ; 

/* 

ICONBLK; 

ptr  to  mask  of  icon  */ 
ptr  to  data  of  icon  */ 
ptr  to  text  of  icon  */ 
character  in  icon  */ 
x-coordinate  of  ib_char  */ 
y-coordinate  of  ib_char  */ 
x-coordlnate  of  icon  */ 
y-coordinate  of  icon  */ 
width  of  icon  in  pixels  */ 
height  of  icon  in  pixels  */ 
x-coordinate  of  the  icon's  text  */ 
y-coordlnate  of  the  Icon's  text  */ 
width  of  rectangle  for  icon's  text  */ 
height  of  icon's  text  in  pixels  */ 


typedef  struct  bit_block 

f 

i 

WORD 

FAR  *bi_pdata; 

/* 

WORD 

bi_wb; 

/* 

WORD 

bi_hl; 

/* 

WORD 

bl_x; 

/* 

WORD 

bi-y; 

/» 

WORD 

bi_color; 

/* 

] BITBLK; 


ptr  to  bit  forms  data  */ 
width  of  form  in  bytes  */ 
height  in  scan  lines  */ 
source  x in  bit  form  */ 
source  y in  bit  form  */ 
fg  color  of  bit  */ 
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typedef  struct  parm_blk 

I 

OBJECT  FAR  *pb_tree;  /*  ptr  to  obj  tree  for  user  defined  obj 

WORD  pb_obj;  /*  index  of  user  defined  object 

WORD  pb_prevstate;  /*  old  state  to  be  changed  */ 

WORD  pb.currstate;  /*  changed  (new)  state  of  object  */ 

WORD  pb_x,  pb_y,  pb_w,  pb_h;  /*  location  of  object  on  screen  */ 

WORD  pb_xc,  pb_yc,  pb_wc,  pb_hcj  /*  current  clipping  rectangle  on  screen  */ 

LONG  pb.parm;  /*  same  as  ub_parni  in  USERBLK  struct  */ 

) PARMBLK; 

typedef  struct  user.blk 

( 

#lf  MSDOS 

WORD  (FAR  *ub_code)  _((V0ID));  /*  pointer  to  drawing  function  */ 

#else 

WORD  CDECL  (FAR  *ub_code)  _(( PARMBLK  »pb));  /*  pointer  to  drawing  function  */ 
#endif 

LONG  ub_parm;  /*  parm  for  drawing  function 

) USERBLK; 

typedef  struct  appl_blk  /*  for  compatibility  */ 

[ 

#if  MSDOS 

WORD  (FAR  *ab_code)  _((V0ID));  /»  pointer  to  drawing  function  */ 

*else 

WORD  CDECL  (FAR  *ab_code)  _( (PARMBLK  *pb));  /*  pointer  to  drawing  function 
#endif 

LONG  ab_parm;  /*  parm  for  drawing  function  */ 

] APPLBLK; 


WORD  objc_add 
WOro  objc_delete 
WORD  obj  c_draw 

WORD  objc_find 

WORD  objc_offset 

WORD  objc_order 
WORD  objc_edit 

WORD  objc_change 


_( (OBJECT  FAR  *tree,  WORD  parent,  WORD  child)); 

.((OBJECT  FAR  »tree,  WORD  delob)); 

.((OBJECT  FAR  *tree,  WORD  drawob,  WORD  depth, 
WORD  xc,  WORD  yc,  WORD  wc,  WORD  he)); 

.((OBJECT  FAR  »tree,  WORD  startob,  WORD  depth, 
WORD  mx,  WORD  my) ) ; 

.((OBJECT  FAR  *tree,  WORD  obj,  WORD  FAR  *poffx, 
WORD  FAR  *poffy)); 

.((OBJECT  FAR  »tree,  WOPiD  mov.obj , WORD  newpos)); 

.((OBJECT  FAR  *tree,  WORD  obj,  WORD  inchar, 

WORD  FAR  *idx,  WORD  kind)); 

.((OBJECT  FAR  *tree,  WORD  drawob,  WORD  depth, 
WORD  xc,  WORD  yc,  WORD  wc,  WORD  he, 

WORD  nestate,  WORD  redraw) ) ; 


Header-Datei  AES.H; 


505 


/*»»*»#  Form  library  »»»*»»*»*«****»»*»***»*«**»»*»«***#»»**«»»*«**»»**»»****»/ 


/*  Form  flags  */ 


# define  FMD.START  0 
# define  FMD.GROW  1 
# define  FMD.SHRINK  2 
♦define  FMD_FINISH  3 
♦define  FMD_ASTART  4 
♦define  FMD.AFINISH  5 


WORD 

form_do 

.({OBJECT  FAR  »form,  WORD  start)); 

WORD 

form_dial 

.({WORD  dtype,  WORD  ix,  WORD  iy,  WORD  iw,  WORD  ih, 
WORD  X,  WORD  y,  WORD  w,  WORD  h) ) ; 

WORD 

form_alert 

.((WORD  defbut,  BYTE  FAR  *astring)); 

WORD 

form_error 

.((WORD  errnum)); 

WORD 

form_center 

.((OBJECT  FAR  *tree,  WORD  FAR  *pcx,  WORD  FAR  ttpcy, 
WORD  FAR  *pcw,  WORD  FAR  *pch)); 

WORD 

form_keybd 

.((OBJECT  FAR  *form,  WORD  obj , WORD  nxt.obj , 

UWORD  thechar,  WORD  FAR  *pnxt_obj , UWORD  FAR  »pchar) ) ; 

WORD 

foriiLbutton 

.((OBJECT  FAR  *form,  WORD  obj,  WORD  elks, 
WORD  FAR  »pnxt.obj))j 

/»»»***  Graphics  library  *******»*****#»**»******«»*»»*♦♦♦*********###»*♦»♦♦**♦, 


/*  Mouse  Forms  */ 


♦define  ARROW 
♦define  TEXT.CRSR 
♦define  HOURGLASS 
♦define  BUSY.BEE 
♦define  POINT_HAND 
♦define  FLAT.HAND 
♦define  THIN.CROSS 
♦define  THICK_CROSS 
♦define  OUTLN.CROSS 
♦ define  M_PUSH 
♦define  M_P0P 
♦define  USER_DEF 
♦define  M_0FF 
♦define  M_0N 


0 

1 

2 

2 /*  for  compatibility  */ 

3 

4 

5 

6 

7 

100 

101' 

255 

256 
257 
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/*  Mouse  Form  Definition  Block  */ 

typedef  struct  mfstr 

[ 

WORD  raf_xhot; 

WORD  mf^yhot; 

WORD  mf_nplanes; 

WORD  mf_fg; 

WORD  mf_bg; 

WORD  mf_mask  [16]; 

WORD  mf_data  [16] ; 

] MFORM; 

WORD  graf_rubbox  _((W0RD  xorigin,  WORD  yorigin,  WORD  wmin,  WORD  brain, 

WOPID  FAR  *pwend,  WORD  FAR  *phend)); 

WORD  graf_dragbox  .((WORD  w,  WORD  h,  WORD  sx,  WORD  sy,  WORD  xc,  WORD  yc, 

WORD  wc,  WORD  he,  WORD  FAR  »pdx,  WORD  FAR  *pdy)}; 

WORD  graf.mbox  .((WORD  w,  WORD  h,  WORD  srex,  WORD  srey, 

WORD  dstx,  WORD  dsty)); 

VOID  graf.growbox  .((WORD  stx,  WORD  sty,  WORD  stw,  WORD  sth, 

WORD  flnx,  WORD  finy,  WORD  finw,  WORD  finh) ) ; 

VOID  graf.shrinkbox  .((WORD  finx,  WORD  finy,  WORD  finw,  WORD  finh, 

WORD  Stx,  WORD  Sty,  WORD  stw,  WORD  sth)); 

WORD  graf.watchbox  .((OBJECT  FAR  *tree,  WORD  obj , WORD  instate, 

WORD  outstate) ) ; 

WORD  graf.slidebox  .((OBJECT  FAR  *tree,  WORD  parent,  WORD  obj, 

WORD  isvert)); 

WORD  graf.handle  .((WORD  FAR  *pwchar,  WORD  FAR  *phchar, 

WORD  FAR  *pwbox,  WORD  FAR  *phbox));  ' 

WORD  graf.raouse  .((WORD  m_number,  MFORM  FAR  *m.addr)); 

VOID  graf.mkstate  .((WORD  FAR  *pmx,  WORD  FAR  *gpmy, 

WORD  FAR  *prastate,  WORD  FAR  *pkstate)); 

/******  Scrap  library  *»»iHt**»*****»**)HHHt*****»*****<HH(»»»»»***»***«***»»»**» 

# define  SCRAP.CSV  0x0001 

# define  SCRAP.TXT  0x0002 

# define  SCRAP.GEM  0x0004 

# define  SCRAP.IMG  0x0008 

# define  SCRAP.DCA  0x0010 

# define  SCRAP.USR  0x8000 

WORD  scrp.read  .((BYTE  FAR  *pscrap)); 

WORD  scrp.write  .((BYTE  FAR  *pscrap)); 


#lf  GEM  & (GEM2  1 GEM3  1 XGEM) 
WORD  scrp.clear  .((VOID)); 
#endif  /*  GEM2  I GEM3  I XGEM*/ 
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/******  File  selector  library  »*»***»**»»»#****«*»»*»*»»#*******#»»***#»»»»»**/ 


WORD  fsel_input  .((BYTE  FAR  »pipath,  BYTE  FAR  »plsel, 

WORD  FAR  »pbutton) ) j 

#if  GEM  & GEMl 

WORD  fsel_exinput  .((BYTE  FAR  *pipath,  BYTE  FAR  *pisel,  WORD  FAR  *pbutton, 

BYTE  »plabel)); 

#endif  /*  GEMl  */ 

Window  library  it**»*«««**«*»*«»#»»»**»»)HHH*»»#»»********»*»)Hf»<HHHf»»**/ 
/*  Window  Attributes  */ 


# define  NAME  0x0001 
# define  CLOSER  0x0002 
# define  FULLER  0x0004 
# define  MOVER  0x0008 
# define  INFO  0x0010 
# define  SIZER  0x0020 
# define  UPARROW  0x0040 
♦define  DNARROW  0x0080 
♦define  VSLIDE  0x0100 
♦define  LFARROW  0x0200 
♦define  RTARROW  0x0400 
♦define  HSLIDE  0x0800 

♦define  HOTCLOSEBOX  0x1000  /*  for  compatibility  */ 
♦define  HOTCLOSE  0x1000 


/*  wind.calc  flags  */ 


♦define  WC.BORDER  0 

♦define  WC.WORK  1 


/*  wlnd.get/wind.set  flags  */ 


♦define 

♦define 

♦ define 
♦define 

♦ define 

♦ define 

♦ define 

♦ define 

♦ define 

♦ define 


WF.KIND 

1 

WF.NAME 

2 

WF.INFO 

3 

WF_WXYWH 

4 

WF.WORKXYWH 

4 /* 

WF.CXYWH 

5 

WF.CURRXYWH 

5 /* 

WF.PXYWH 

6 

WF.PREVXYWH 

6 /* 

WF.FXYWH 

7 

for  compatibility  */ 
for  compatibility  */ 
for  compatibility  */ 
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# define  WF_FULLXYyH  7 /* 

# define  WF_HSLIDE  8 

♦ define  WF.VSLIDE  9 

# define  WF^TOP  10 

# define  WF_FIRSTXYWH  11 

# define  WF_NEXTXYWH  12 

♦define  WF_IGN0RE  13 

♦define  WF^NEWDESK  14 

♦define  WF_HSLSIZE  15 

♦define  WF.VSLSIZE  16 

♦define  WF.SCREEN  17 

♦define  WF.TATTRB  18 

♦define  WF.SIZTOP  19 

♦define  WF.TOPAP  20 

/*  update  flags  */ 

♦define  END.UPDATE  0 

♦ define  BEG.UPDATE  1 

♦define  END.MCTRL  2 

♦define  BEG.MCTRL  3 

♦define  BEG.EMERG  4 

♦ define  END_EMERG  5 

/*  arrow  message  »/ 

♦define  WA_SUBWIN  1 

♦define  WA_KEEPWIN  2 

♦define  WA_UPPAGE  0 /« 

♦define  WA-DNPAGE  1 /* 

♦define  WA.UPLINE  2 /* 

♦define  WA.DNLINE  3 /* 

♦define  WA_LFPAGE  4 /* 

♦define  WA_RTPAGE  5 /* 

♦define  WA_LFLINE  6 /* 

♦define  WA_RTLINE  7 /* 


for  compatibility  */ 


Window  Arrow 
Window  Arrow 
Window  Arrow 
Window  Arrow 
Window  Arrow 
Window  Arrow 
Window  Arrow 
Window  Arrow 


Up  Page  */ 
Down  Page  */ 
Up  Line  */ 
Down  Line  */ 
Left  Page  »/ 
Right  Page  »/ 
Left  Line  »/ 
Right  Line  */ 


WORD  wind^create 
WORD  wind_open 
WORD  wind_close 
WORD  wind_delete 

♦ if  GEMDOS 
WORD  wind_get 
WORD  wind_set 

♦ else 


_( (DWORD  kind,  WORD  wx,  WORD  wy,  WORD  ww,  WORD  wh) ) ; 
_{{W0RD  handle,  WORD  wx,  WORD  wy,  WORD  ww,  WORD  wh)) 
_({W0RD  handle)); 

_((W0RD  handle)); 

_((W0RD  w_handle,  WORD  wfield,  ...)); 

_( (WORD  w_handle,  WORD  wfield,  ...)); 
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WORD 

wind_get 

_( (WORD 
WORD 

WORD 

wind.set 

.((WORD 

WORD 

#endif 

WORD 

wind_find 

.((WORD 

WORD 

wind. update 

.((WORD 

WORD 

wind.calc 

.((WORD 

WORD 

WORD 

WORD 

w_handle,  WORD  wfield, 

*pwl,  WORD  *pw2,  WORD  »pw3,  WORD  »pw4)); 

w_handle,  WORD  wfield, 

wl,  WORD  w2,  WORD  w3,  WORD  w4)); 

mx,  WORD  my)); 
beg_update) ) ; 
wctype,  DWORD  kind, 

X,  WORD  y,  WORD  w,  WORD  h, 

FAR  *px,  WORD  FAR  *py, 

FAR  »pw,  WORD  FAR  *ph)); 


#if  GEM  & GEMl 

VOID  wind_new  _((VOID)); 

#endlf  /»  GEMl  */ 


#if  GEM  & XGEM 

WORD  wind^apflnd  .((WORD  mx,  WORD  my)) ; 
#endif  /*  XGEM  */ 


/*«»***  Resource  library  »**»**«*»****»»»»»***»*******»»»»************»«*»»»»*/ 


/*  data 

Structure  types  */ 

# define 

R.TREE 

0 

# define 

R.OBJECT 

1 

# define 

R.TEDINFO 

2 

# define 

R.IC0NBLK 

3 

# define 

R.BITBLK 

4 

♦ define 

R.STRING 

5 

/* 

gets  pointer  to  free  strings 

V 

♦ define 

R.IMAGEDATA 

6 

/* 

gets  pointer  to  free  images 

V 

♦ define 

R.0BSPEC 

7 

♦ define 

R.TEPTEXT 

8 

/* 

sub  ptrs  in  TEDINFO 

*/ 

♦ define 

R.TEPTMPLT 

9 

♦ define 

R.TEPVALID 

10 

♦ define 

R.IBPMASK 

11 

/» 

sub  ptrs  in  ICONBLK 

*/ 

♦ define 

R.IBPDATA 

12 

♦ define 

R.IBPTEXT 

13 

♦define 

R.BIPDATA 

14 

/» 

sub  ptrs  in  BITBLK 

*/ 

♦define 

R.FRSTR 

15 

/* 

gets  addr  of  ptr  to  free  strings 

*/ 

♦ define 

R.FRIMG 

16 

/* 

gets  addr  of  ptr  to  free  Images 

*/ 

/»  used  in  RECREATE. C */ 
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typedef  struct  rshdr 

[ 

UWORD  rsh_vrsn; 

UWORD  rsh_object; 

UWORD  rsh.tedinfo; 

UWORD  rsh.lconblk;  /»  list  of  ICONBLKS  */ 

UWORD  rsh_bltblkj 
UWORD  rsh_frstrj 
UWORD  rsh_strlng; 

UWORD  rsh_lmdata;  /*  image  data  »/ 

UWORD  rsh_frlmg; 

UWORD  rsh_tr index; 

UWORD  rsh_nobs;  /*  counts  of  various  structs  */ 

UWORD  rsh_ntree; 

UWORD  rsh_nted; 

UWORD  rsh_nib ; 

UWORD  rsh_nbb; 

UWORD  rsh.nstring; 

UWORD  rsh_nimages; 

UWORD  rsh_rsslze;  total  bytes  in  resource  */ 

] RSHDR; 

# define  F.ATTR  0 /*  file  attr  for  dos.create  */ 

WORD  rsrc_load  _{(BYTE  FAR  *rsname)); 

WORD  rsrc.free  _((V0ID)); 

WORD  rsrc.gaddr  _({WORD  rstype,  WORD  rsid,  VOID  FAR  «paddr) ) ; 

WORD  rsrc.saddr  _((WORD  rstype,  WORD  rsid,  VOID  FAR  *lngval)); 

WORD  rsrc.obfix  .((OBJECT  FAR  *tree,  WORD  obj)); 

/***#»*  Shell  library  ***********»)HHt**»»******»»»»»»******»»»»»»**»*»»»**»»** 

» 

WORD  shel.read  .((BYTE  FAR  *pcmd,  BYTE  FAR  *ptail)); 

WORD  shel.wrlte  .((WORD  doex,  WORD  isgr,  WORD  isover,  BYTE  FAR  *pcmd, 

BYTE  FAR  »ptail)); 

WORD  shel.get  .((BYTE  FAR  *addr,  WORD  len)); 

WORD  shel.put  .((BYTE  FAR  *addr,  WORD  len)); 

WORD  shel.flnd  .((BYTE  FAR  *ppath)); 

WORD  sheLenvrn  .((BYTE  FAR  * FAR  *ppath,  BYTE  FAR  *psrch)); 

#if  GEM  & (GEM2  1 GEM3) 

WORD  shel.rdef  .((BYTE  FAR  *lpcmd,  BYTE  FAR  *lpdlr)); 

WORD  shel.wdef  .((BYTE  FAR  *lpcmd,  BYTE  FAR  *lpdir)); 

ttendif  /*  GEM2  1 GEM3  */  *\ 
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Extended  graphics  library  **»»»»»**»*»*»*»»»»»»»***»»***»»»»«»»*»»»»»*/ 
#if  GEM  & (GEM2  1 GEM3  1 XGEM) 

WORD  xgrf_stepcalc  .((WORD  orgWj  WORD  orgh,  WORD  xc,  WORD  yc, 

WORD  w,  WORD  h,  WORD  FAR  »pcx,  WORD  FAR  »pcy, 

WORD  FAR  »pcnt,  WORD  FAR  *pxstep,  WORD  FAR  »pystep)); 
WORD  xgrf_2box  .((WORD  xc,  WORD  yc,  WORD  w,  WORD  h,  WORD  corners, 

WORD  cnt,  WORD  xstep,  WORD  ystep,  WORD  doubled)); 
#endif  /»  GEM2  I GEM3  I XGEM  »/ 

/*»»»»»»**»»*»»*»*»»*»*»»*»»»»*»»****»*»»»»*»*»»»*»»**»*»»*»»»**»***»**»*****»/ 
#endif  /*  __AES__  */ 
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/»»**»*»»**»*»»***»»»******»»»*»*»»»»****»*»»»»»»»»»*»***»»****»»»»»»*»»»»*»»*/ 
/*  VDI.H:  Common  VDI  definitions  and  structures.  */ 

/»*»*»»»»»***»»»»**»»»**»»**»»***»»»*»*»*»**»»*»»»*»»»»»****»******»»»*»»»**»»/ 
/»  */ 

/*  Authors:  Dieter  & Juergen  Geiss  */ 

/*  */ 

#ifndef  ..VDI_ 

# define  ..VDI_ 


/«*»**»  Control  library  »»»»****»*»****»»»*****»***»»*«»»»*»»****»*»»»**»»»»*»/ 


# define 

OW.FILE 

0 

# define 

OW.SERIAL 

1 

# define 

OW.PARALLEL 

2 

# define 

0W.DEVICE 

3 

# define 

0W.N0CHANGE 

255 

# define 

OW.LETTERl 

0 

# define 

0W.HALF 

5 

# define 

0W.B5 

10 

# define 

0W.LETTER2 

20 

# define 

0W.A4 

30 

# define 

OW.LEGAL 

40 

# define 

0W.D0UBLE 

50 

# define 

0W.BR0AD 

55 

# define 

OW.INDIRECT 

255 

output  device  type  in  the  low-order  byte  */ 


page  size  index  in  the  high-order  byte  */ 


use  work_ln  [101]  and  work.in  [102]  */ 


512 


Anhang  A.  Header-Daieien 


VOID  v_get_driver_lnfo 

VOID  v_opnwk 

VOID  v_clswk 
VOID  v_clrwk 
VOID  v_updwk 
VOID  v_opnvwk 

VOID  v_clsvwk 
WORD  vst_load_fonts 
VOID  vst_unload_ fonts 
WORD  vst_ex_load_ fonts 

VOID  vs.cUp 
VOID  v_set_app_buff 
WORD  v_bez_on 
WORD  v_bez_off 
WORD  v_bea_qual 
VOID  v_pat_rotate 

/»»»»»»  Output  library 

VOID  v.pline 
VOID  v.pmarker 
VOID  v.gtext 
VOID  v_etext 

VOID  v.fillarea 
VOID  v.cellarray 


VOID  v_bar 
VOID  v_arc 

VOID  v_pieslice 

VOID  v_circle 
VOID  v_ellipse 

VOID  v_ellarc 

VOID  v.ellpie 

VOID  v_rbox 
VOID  v.rfbox 


_((WORD  device.id,  WORD  info_select, 

UBYTE  FAR  *info_strlng) ) ; 

_((WORD  FAR  »work_in,  WORD  FAR  ^handle, 

WORD  FAR  »work_out))j 
_((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle)); 

.((WORD  FAR  »work.in,  WORD  FAR  ^handle, 

WORD  FAR  *work.out)); 

.((WORD  handle)); 

.((WORD  handle,  WORD  select)); 

.((WORD  handle,  WORD  select)); 

.((WORD  handle,  WORD  select,  WORD  font.max, 

WORD  font.free)); 

.((WORD  handle,  WORD  clip.flag,  WORD  FAR  *pxyarray)); 
.((VOID  FAR  ^address,  WORD  nparagraphs) ) ; 

.((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle,  WORD  prcnt)); 

.((WORD  handle,  WORD  angle)); 

»*«**»*»#**«»»**»»»»****»*«****»*»»»*»*»»»**»»«»»»«»»*♦ 


.((WORD  handle,  WORD  count,  WORD  FAR  *xy)); 

.((WORD  handle,  WORD  count,  WORD  FAR  *xy)); 

.((WORD  handle,  WORD  x,  WORD  y,  BYTE  FAR  ^String)); 

.((WORD  handle,  WORD  x,  WORD  y,  UBYTE  FAR  » string, 
WORD  FAR  ^offsets)); 

.((WORD  handle,  WORD  count,  WORD  FAR  *xy)); 

.((WORD  handle,  WORD  FAR  *pxyarray,  WORD  row.length, 
WORD  el.used,  WORD  num.rows,  WORD  wrt.raode, 

WORD  FAR  *colarray) ) ; 

.((WORD  handle,  WORD  FAR  *pxyarray)); 

.((WORD  handle,  WORD  x,  WORD  y,  WORD  radius, 

WORD  begang,  WORD  endang)); 

.((WORD  handle,  WORD  x,  WORD  y,  WORD  radius, 

WORD  begang,  WORD  endang)); 

.((WORD  handle,  WORD  x,  WORD  y,  WORD  radius)); 

.((WORD  handle,  WORD  x,  WORD  y,  WORD  xradius, 

WORD  yradius)); 

.((WORD  handle,  WORD  x,  WORD  y,  WORD  xradius, 

WORD  yradius,  WORD  begang,  WORD  endang)); 

.((WORD  handle,  WORD  x,  WORD  y,  WORD  xradius, 

WOEID  yradius,  WORD  begang,  WORD  endang)); 

.((WORD  handle,  WORD  FAR  »xyarray)); 

.((WORD  handle,  WORD  FAR  »xyarray)); 
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VOID  v_justlfied 

VOID  v_contourfill 
VOID  vr_recfl 
VOID  v_bez 


VOID  v.bezfill 


_({W0RD  handle,  WORD  x,  WORD  y,  BYTE  FAR  ^string, 

WORD  length,  WORD  word_space,  WORD  char_space) ) ; 
.((WORD  handle,  WORD  x,  WORD  y,  WORD  index)); 

.((WORD  handle,  WORD  FAR  »pxyarray)); 

.((WORD  handle,  WORD  count,  WORD  FAR  *xyarr, 

UBYTE  FAR  »bezarr,  WORD  FAR  *mlnmax,  WORD  FAR  *npts, 
WORD  FAR  *nmove) ) ; 

.((word  handle,  WORD  count,  WORD  FAR  *xyarr, 

UBYTE  FAR  *bezarr,  WORD  FAR  *minmax,  WORD  FAR  *npts, 
WORD  FAR  *nmove) ) ; 


/*»**»* 

Attribute  library  * 

# define 

MD.REPLACE 

1 

#define 

MD.TRANS 

2 

# define 

MD.X0R 

3 

# define 

MD.ERASE 

4 

# define 

FIS.HOLLOW 

0 

# define 

FIS.SOLID 

1 

# define 

FIS.PATTERN 

2 

# define 

FIS.HATCH 

3 

# define 

FIS.USER 

4 

# define 

ALL.WHITE 

0 

# define 

S.AND.D 

1 

♦ define 

S.AND.NOTD 

2 

# define 

S.ONLY 

3 

♦ define 

N0TS.AND.D 

4 

♦ define 

D.ONLY 

5 

♦ define 

S.XOR.D 

6 

♦ define 

S.OR.D 

7 

♦ define 

NOT.SORD 

8 

♦ define 

NOT.SXORD 

9 

♦ define 

D_ INVERT 

10 

♦ define 

S.OR.NOTD 

11 

♦ define 

NOT.D 

12 

♦ define 

NOTS.OR.D 

13 

♦ define 

NOT.SANDD 

14 

♦ define 

ALL.BLACK 

15 

♦ ifndef 

WHITE 

♦ define 

WHITE 

0 

♦ define 

BLACK 

1 

♦ define 

RED 

2 

♦ define 

GREEN 

3 

/*  gsx  modes  */ 


/*  gsx  styles  */ 


/*  colors  */ 
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# define 

BLUE 

4 

# define 

CYAN 

5 

# define 

YELLOW 

6 

# define 

MAGENTA 

7 

# define 

DWHITE 

8 

# define 

DBLACK 

9 

# define 

DEED 

10 

♦ define 

DGREEN 

11 

♦ define 

DBLUE 

12 

♦define 

DCYAN 

13 

♦define 

DYELLOW 

14 

♦define 
♦ endif 

DMAGENTA 

15 

♦ define 

SOLID 

1 /*  line  types  */ 

♦ define 

LONGDASH 

2 

♦ define 

DOT 

3 

♦ define 

DASHDOT 

4 

♦ define 

DASH 

5 

♦ define 

DASH2DOT 

6 

♦define 

USERLINE 

7 

♦define 

SQUARED 

0 /*  line  ends  */ 

♦define 

ARROWED 

1 

♦ define 

ROUNDED 

2 

♦ define 

PM_DOT 

1 /*  polymarker  types  */ 

♦ define 

PM_PLUS 

2 

♦ define 

PM_ ASTERISK 

3 

♦ define 

PM_SQUARE 

4 

♦define 

PM_DIAGCROSS 

5 

♦ define 

PM_DIAMOND 

6 

♦ define 

TXT_NORMAL 

0x0000  /*  text 

effects  */ 

♦ define 

TXT.THICKENED 

0x0001 

♦ define 

TXT.LIGHT 

0x0002 

♦ define 

TXT^SKEWED 

0x0004 

♦define 

TXT.UNDERLINED 

0x0008 

♦define 

TXT_OUTLINED 

0x0010 

♦define 

TXT_SHADOWED 

0x0020 

♦ define 

ALI^LEFT 

0 /*  horizontal 

text  alignment 

♦ define 

ALI.CENTER 

1 

♦ define 

ALI_RIGHT 

2 
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# define  ALI_BASE 
# define  ALI_HALF 
# define  ALI .ASCENT 
# define  ALI.BOTTOM 
# define  ALI.DESCENT 
# define  ALI.TOP 


/*  fill  pattern  */ 


typedef  struct  patarray 

( 

WORD  patword  [l6] ; 
j FILLPAT; 


WORD  vswr.mode 
VOID  vs.color 
WORD  vsl_type 
VOID  vsl.udsty 
WORD  vsl.width 
WORD  vsl_color 
VOID  vsl.ends 
WORD  vsnutype 
WORD  vsm.height 
WORD  vsm_color 
VOID  vst_height 


WORD  vst.point 


WORD  vst.rotation 
WORD  vst.font 
WORD  vst.color 
WORD  vst.effects 
VOID  vst.alignment 

WORD  vsf.interior 
WOEID  vsf.style 
WORD  vsf.color 
WORD  vsf.perinieter 
VOID  vsf.udpat 
VOID  vs.grayoverride 


0 /*  vertical  text  alignitient  */ 

1 
2 

3 

4 

5 


((WORD  handle,  WORD  mode)); 

((WORD  handle,  WORD  index,  WORD  FAR  »rgb_in)); 
((WORD  handle,  WORD  style)); 

((WORD  handle,  WORD  pattern)); 

((WORD  handle,  WORD  width)); 

((WORD  handle,  WORD  color.index) ) ; 

((WORD  handle,  WORD  beg.style,  WORD  end.style)); 
((WORD  handle,  WORD  symbol)); 

((WORD  handle,  WORD  height)); 

((WORD  handle,  WORD  color.index) ) ; 

((WORD  handle,  WORD  height, 

WORD  FAR  *char_wldth,  WORD  FAR  *char_height, 
WORD  FAR  *cell_width,  WORD  FAR  *cell.height) ) ; 
.((WORD  handle,  WORD  point, 

WORD  FAR  *char_wldth,  WORD  FAR  *char_height, 
WORD  FAR  *cell_width,  WORD  FAR  »cell_height) ) ; 
((WORD  handle,  WORD  angle)); 

((WORD  handle,  WORD  font)); 

((WORD  handle,  WORD  color.index) ) ; 

((WORD  handle,  WORD  effect)); 

((WORD  handle,  WORD  hor.in,  WORD  vert.ln, 

WORD  FAR  *hor_out,  WORD  FAR  *vert_out)); 

((WORD  handle,  WORD  style)); 

((WORD  handle,  WORD  style.index) ) ; 

((WORD  handle,  WORD  color.index) ) ; 

.((WORD  handle,  WORD  per.vls,  WORD  per.style)); 
.((WORD  handle,  WORD  FAR  »pfill_pat,  WORD  planes)) 
.((WORD  handle,  WORD  grayval)); 
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Raster  library  *»**************»*******»»»*****»*************x»*»»*iHt* 
/X  Memory  Form  Definition  Block  */ 
typedef  struct  meraform 

I 

VOID  FAR  »mp; 

WORD  fwp; 

WORD  fhj 
WORD  fww; 

WORD  ff; 

WORD  np; 

WORD  rl; 

WORD  r2; 

WORD  r3; 
j MFDB; 

typedef  struct  fdbstr  /*  for  compatibility  */ 

[ 

VOID  FAR  Xfd_addr; 

WORD  fd_wj 
WORD  fd_h; 

WORD  fd.wdwidth; 

WORD  fd_stand; 

WORD  fd_nplanes; 

WORD  fd_rl; 

WORD  fd_r2; 

WORD  fd,..r3; 

] FDBj 

VOID  v_get_pixel  .((WORD  handle,  WORD  x,  WORD  y,  WORD  FAR  Xpel, 

WORD  FAR  » index)); 

VOID  vro.epyfm  _((WORD  handle,  WORD  wr.mode,  WORD  FAR  *xy, 

MFDB  FAR  XsrcMFDB,  MFDB  FAR  XdesMFDB)); 

VOID  vr.trnfra  .((WORD  handle,  MFDB  FAR  xsrcMFDB,  MFDB  FAR  »desMFDB)); 

VOID  vrt.cpyfra  .((WORD  handle,  WORD  wr.mode,  WORD  FAR  #xy, 

MFDB  FAR  »srcMFDB,  MFDB  FAR  *desMFDB, 

WORD  FAR  * index) ) ; 

/xxxxxx  Input  library  »x*»xxxx*»*»»»»xxxx*xxx***x*»xxxx**x***x#xx*x»xxxx***xx* 

# define  DEV.LOCATOR  1 /*  input  device  */ 

#deflne  DEV.VALUATOR  2 

# define  DEV.CHOICE  3 

# define  DEV.STRING  4 
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# define  MODE_REQUEST 
# define  MODE_SAMPLE 

VOID  vsin^mode 
VOID  vrq_locator 

WORD  vsm_locator 

VOID  vrq.valuator 

VOID  vsm_ valuator 

VOID  vrq_choice 
WORD  vsm_choice 
VOID  vrq.string 

WORD  vsm_string 

VOID  vsc.form 
VOID  vex_tirav 

VOID  v_show_c 
VOID  v_hide_c 
VOID  vq_mouse 

VOID  vex_butv 

VOID  vex_motv 

VOID  vex_curv 

VOID  vq_key.s 

/»»»*»*  Inquire  library 

VOID  vq_color 

VOID  vq_cellarray 


VOID  vql.attributes 
VOID  vqiiL attributes 
VOID  vqf„attributes 
VOID  vqt_attributes 
VOID  vq_extnd 


1 /*  input  mode  */ 

2 

((WORD  handle,  WORD  dev_type,  WORD  mode)); 

((WORD  handle,  WORD  initx,  WORD  inity, 

WORD  FAR  *xout,  WORD  FAR  *yout,  WORD  FAR  *term)); 
((WORD  handle,  WORD  initx,  WORD  inity, 

WORD  FAR  »xout,  WORD  FAR  *yout,  WORD  FAR  »term)); 
((WORD  handle,  WORD  val_in,  WORD  FAR  *val_out, 

WORD  FAR  »term)); 

((WORD  handle,  WORD  val_in,  WORD  FAR  *val_out, 

WORD  FAR  *term,  WORD  FAR  »status)); 

((WORD  handle,  WORD  in_choice,  WORD  FAR  *out_choiee) ) j 
((WORD  handle,  WORD  FAR  ^choice)); 

((WORD  handle,  WORD  length,  WORD  echo_mode, 

WORD  FAR  *echo_xy,  BYTE  FAR  ^string)); 

((WORD  handle,  WORD  length,  WORD  echo_mode, 

WORD  FAR  *echo_xy,  BYTE  FAR  ^string)); 

.((WORD  handle,  WORD  FAR  *cur_form)); 

.((WORD  handle,  WORD  (FAR  *tim_addr) ( ) , 

WORD  (FAR  * FAR  *old_addr) ( ) , WORD  FAR  *scale))j 
((WORD  handle,  WORD  reset)); 

((WORD  handle)); 

.((WORD  handle,  WORD  FAR  ^^status,  WORD  FAR  ^^px, 

WORD  FAR  *py) ) ; 

.((WORD  handle,  WORD  (FAR  *usercode) ( ) , 

WORD  (FAR  * FAR  *savcode) ( ) ) ) ; 

.((WORD  handle,  WORD  (FAR  *usercode) () , 

WORD  (FAR  FAR  *savecode)  ( ) ) ) ; 

.((WORD  handle,  WORD  (FAR  *usereode) ( ) , 

WORD  (FAR  * FAR  *savecode) ( ) ) ) ; 

.((WORD  handle,  WORD  FAR  ^status)); 

**^HnHHt»**»»»**«**»»*****»*»*******»X»»»i^»in^  If  If  ********/ 


((WORD  handle,  WORD  index,  WORD  set.flag, 

WORD  FAR  *rgb)); 

((WORD  handle,  WORD  FAR  *pxyarray, 

WORD  row_length,  WORD  num_rows, 

WORD  FAR  »el_used,  WORD  FAR  >rows_used, 

WORD  FAR  ^status,  WORD  FAR  ^colarray)); 

((WORD  handle,  WORD  FAR  *attrib)); 

((WORD  handle,  WORD  FAR  *attrib)); 

.((WORD  handle,  WORD  FAR  *attrib)); 

.((WORD  handle,  WORD  FAR  *attrib)); 

((WORD  handle,  WORD  owflag,  WORD  FAR  *work_out)); 


518 


Anhang  A.  Header-Dateien 


VOID 

vqln_mode 

_((WORD 

VOID 

vqt_extent 

_((WORD 

WORD 

vqt_width 

_((¥ORD 

WORD 

WORD 

vqt_name 

-((WORD 

VOID 

vqt_font_info 

-((WORD 

WORD 

WORD 

WORD 

vqt.justified 

-((WORD 

WORD 

WORD 

handle,  WORD  dev_type,  WORD  FAR  #input_mode) ) ; 
handle,  BYTE  FAR  *string,  WORD  FAR  ^extent)); 
handle,  BYTE  character,  WORD  FAR  *cell_wldth, 
FAR  *left.delta,  WORD  FAR  *rlght_delta) ) ; 
handle,  WORD  element_num,  BYTE  FAR  »name))j 
handle,  WORD  FAR  *minADE,  WORD  FAR  *maxADE, 
FAR  *distances,  WORD  FAR  *maxwidth, 

FAR  ^effects)); 

handle,  WORD  x,  WORD  y,  BYTE  FAR  ^string, 
length,  WORD  word_spaee,  WORD  char_space, 

FAR  *offsets)); 


/»#*■#**  Escape  library  *****»»»*»»***»**»»»*»»*****»»***»»»»»»**»#»»***»»»**»*, 

/»  OUT-Flle  definitions  for  v_alpha_text  */ 


# define 

O-B-BOLDFACE 

'O' 

♦ define 

O-E-BOLDFACE 

'1' 

♦define 

O-B-ITALICS 

'2' 

♦ define 

O-E- I TADICS 

'3' 

♦ define 

O-B-UNDERSCORE 

■4' 

♦ define 

O-E-UNDERSCORE 

'5' 

♦ define 

O-B-SUPERSCRIPT 

'6' 

♦ define 

0-E-SUPERSCRIPT 

,7, 

♦define 

O-B-SUBSCRIPT 

'8' 

♦ define 

0_E_SUBSCRIPT 

.9. 

♦define 

O-B-NLQ 

'A' 

♦define 

O-E-NLQ 

'B' 

♦define 

0_B_EXPANDED 

'C 

♦define 

O-E-EXPANDED 

'D' 

♦ define 

0-B-LIGHT 

'E' 

♦ define 

0_E_LIGHT 

tpi 

♦ define 

O-PICA 

'W' 

♦ define 

O-ELITE 

'X' 

♦ define 

0- CONDENSED 

'Y' 

♦ define 

O-PROPORTIONAL 

'Z' 

♦ define 

0_GRAPHICS 

"\03 

♦ define 

MUTE-RETURN 

-1  /» 

♦ define 

MUTE-ENABLE 

0 

♦ define 

MUTE-DISABLE 

1 

♦ define 

OR-PORTRAIT 

0 /* 

♦ define 

OR-LANDSCAPE 

1 

♦ define 

TRAY-MANUAL 

-1  /» 

♦ define 

TRAY-DEFAULT 

0 

♦ define 

TRAY-FIRSTOPT 

1 

\033\033GEM,  iSd,  ^d,  i?d,?5d,  ^s" 
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# define  XBIT.FRACT 
# define  XBIT_INTEGER 


# define  XBIT_LEFT 
# define  XBIT_ CENTER 
# define  XBIT_RIGHT 


#define  XBIT.TOP 
# define  XBIT_MIDDLE 
# define  XBIT.BOTTOM 

VOID  vq_chcells 

VOID  v_exit_cur 

VOID  v_enter_cur 

VOID  v_curup 

VOID  v_Gurdown 

VOID  v_curright 

VOID  v_curleft 

VOID  v_curhome 

VOID  v_eeos 

VOID  v_eeol 

VOID  vs_curaddress 

VOID  v_curtext 

VOID  v_rvon 

VOID  v.rvoff 

VOID  vq_curaddress 

WORD  vq_tabstatus 

VOID  v_hardcopy 

VOID  v_dspcur 

VOID  v.rmcur 

VOID  v_form_adv 

VOID  v_output_window 

VOID  v_clear_disp_list 

VOID  v_blt_image 


VOID  vq_scan 


VOID  v_alpha_text 
WORD  vs_palette 
VOID  v_sound 
WORD  vs^mute 
VOID  vt_resolution 


0 /*  definitions  for  v_xblt_ image  */ 

1 

0 

1 

2 

0 

1 

2 

_((W0RD  handle,  WORD  FAR  *rows,  WORD  FAR  ^columns)); 

_( (WORD  handle) ) ; 

_((WORD  handle)); 

_((WORD  handle)); 

^((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle^; 

.((WORD  handle}); 

.((WORD  handle}); 

.((WORD  handle)}; 

.((WORD  handle,  WORD  row,  WORD  column}}; 

.((WORD  handle,  BYTE  FAR  ^String}}; 

.((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle,  WORD  FAR  *row,  WORD  FAR  ^column) ) ; 
.((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle,  WORD  x,  WORD  y)); 

.((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle,  WORD  FAR  *xyarray)}; 

.((WORD  handle}}; 

.((WORD  handle,  CONST  BYTE  FAR  ^filename, 

WORD  aspect,  WORD  x.scale,  WORD  y.scale, 

WORD  h.allgn,  WORD  v.align,  WORD  FAR  i^xyarray)); 
.((WORD  handle,  WORD  FAR  *g.height,  WORD  FAR  *g.slices, 
WORD  FAR  *a.height,  WORD  FAR  »a.slices, 

WORD  FAR  »factor)); 

.{(WORD  handle,  BYTE  FAR  ^string}}; 

.((WORD  handle,  WORD  palette)}; 

.((WORD  handle,  WORD  frequency,  WORD  duration}}; 
.((WORD  handle,  WORD  action)); 

.((WORD  handle,  WORD  xres,  WORD  yres, 

WORD  FAR  *xset,  WORD  FAR  *yset}}; 
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VOID  vt_axis 

VOID  vt_origin 
VOID  vq_tdiraensions 

VOID  vt_alignment 
VOID  vsp.film 
WORD  vqp_filnmaiiie 
VOID  vsc_expose 
VOID  v_meta_extents 

VOID  v_write_meta 

VOID  vm_filename 
VOID  vm_pageslze 
VOID  vra_coords 

VOID  v_coples 
VOID  v_orient 
VOID  v_tray 
WOEID  v.xbit.  Image 


VOID  vs_bkeolor 
VOID  v.setrgbi 

VOID  v_topbot 


VOID  v_ps_halftone 


.((WORD  handle,  WORD  xres,  WORD  yres, 

WORD  FAR  *xset,  WORD  FAR  »yset)); 

.((WORD  handle,  WORD  xorigln,  WORD  yorigln)); 

.((WORD  handle,  WORD  FAR  »xdimension, 

WORD  FAR  »ydimenslon) ) ; 

.((WORD  handle,  WORD  dx,  WORD  dy)); 

.((WORD  handle,  WORD  Index,  WORD  lightness)); 

.((WORD  handle,  WORD  Index,  BYTE  FAR  *name)); 

.((WORD  handle,  WORD  State)); 

.((WORD  handle,  WORD  min.x,  WORD  roln.y, 

WORD  max.x,  WORD  raax.y)); 

.((WORD  handle,  WORD  num.lntin,  WORD  FAR  *intin, 

WORD  num.ptsin,  WORD  FAR  *ptsln)); 

.((WORD  handle,  CONST  BYTE  FAR  ^filename)); 

.((WORD  handle,  WORD  pgwidth,  WORD  pgheight)); 

.((WORD  handle,  WORD  llx,  WORD  lly, 

WORD  urx,  WORD  ury)); 

.((WORD  handle,  WORD  count)); 

.((WORD  handle,  WORD  orientation)); 

.((WORD  handle,  WORD  tray)); 

.((WORD  handle,  BYTE  FAR  ^filename,  WORD  aspect, 

WORD  x.scale,  WORD  y.scale, 

WORD  h.align,  WORD  v.align,  WORD  rotate, 

WORD  background,  WORD  foreground,  WORD  FAR  *xy)); 

.((WORD  handle,  WORD  color)); 

.((WORD  handle,  WORD  primtype,  WORD  r,  WORD  g,  WORD  b, 
WORD  i)); 

.((WORD  handle,  WORD  height, 

WORD  FAR  »char_width,  WORD  FAR  *char.height, 

WORD  FAR  *cell.width,  WORD  FAR  »cell.helght) ) ; 

.((WORD  handle,  WORD  index,  WORD  angle, 

WORD  frequency) ) ; 


#if  GEM  & GEMl 
VOID  vqp.films 
VOID  vqp. state 


VOID  vsp.state 


VOID  vsp.save 
VOID  vsp_message 
WORD  vqp.error 


.((WORD  handle,  BYTE  FAR  »filni_names) ) ; 

.((WORD  handle,  WORD  FAR  *port,  BYTE  FAR  *film.naine, 
WORD  FAR  Slightness,  WORD  FAR  »interlace, 

WORD  FAR  splanes,  WORD  FAR  ^indexes)); 

.((WORD  handle,  WORD  port,  WORD  filra.num, 

WORD  lightness,  WORD  interlace,  WORD  planes, 

WORD  FAR  sindexes)); 

.((WORD  handle)); 

.((WORD  handle)); 

.((WORD  handle)); 
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VOID  v_offset 
VOID  v_fontlnit 
VOID  v_escape2000 
WORD  vq_gdos 
#endif  /*  GEMl  */ 


_((WORD  handle,  WORD  offset)); 

_((W0RD  handle,  WORD  fh.high,  WORD  fh_low)); 
_((W0RD  times)); 

-((VOID)); 


/xx»*»***»»»»*»»»**»»**»**********»»»***»*»»**»«*******»****»**«**»»»»»***»»»*/ 


#endif  /*  „VDI__  »/ 
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a)  GEMDOS 

- Digital  Research  C (Alcyon  C) 

Datei  C.BAT: 

cp68  %l.c  %l.i 

c068  %l.i  %1.1  %1.2  %1.3  -f 

del  %l.i 

cl68  %1.1  %1.2  ?l.s 
del  i\.\ 
del  %1.2 
as68  -1  -u  ?5l.s 
del  %l.s 

ar68  rv  scraplib  %l.o 
del  %l.o 


Datei  C_ALL.BAT: 

c gemain 
c initerm 
c graf 
c power 
c edit 
c image 
c meta 
c clipbrd 
c printer 
c disk 
c trash 
c desktop 
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c event 
c menu 
c resource 
c rcra 
c windows 
c global 
1 


Datei  L.BAT: 

1 ink68  sc  rap . 68k= gems tart , scraplib , vdib ind , aesb Ind , osb ind , geml lb , 1 ib  f 
relmod  scrap. 68k 
del  scrap. 68k 

- Laser  C 
Datei  MAKEFILE: 

# # # # # MAKEFILE  fur  SCRAP  # # # # # 

############################################################################ 
NAME  = scrap 

############################################################################ 
CFLAGS  = 

LFLAGS  = 

APP  = . prg 

II  If  II  II  n If  ri  fl  II  II  II  IP  II  Tl  II  II  II  H 11  If  M If  M M II  M H H It  If  tr  ff  ft  If  II  W It  ft  f1  t1  W 

H = import. h export. h global. h 

OBJS  = clipbrd.o  desktop.©  dlsk.o  edit.o  event. o gemain.o  global. o graf.oV 
image. o inlterm.o  menu.o  meta.o  power. o printer. o rcm.o  resource. o\ 
trash. o windows. o 

##########################################«:################################# 


Make-  und  Projekt-Dateien 


525 


$(NAME)$(APP) : $(OBJS) 

$(CC)  $(OBJS)  $(LFLAGS)  -o  $@ 

»»»#»»»»»»#»##*###»***##»»»»*»»*###*»***«»*»»#*»**##****#######****»###***#* 

cllpbrd.o  : $(H)  windows. h $(NAME).h  resource. h desktop. h edit.h  Image. h\ 
meta.h  trash. h clipbrd.h 

desktop. o : $(H)  windows. h $(NAME).h  clipbrd.h  disk.h  event. h menu.h  printer. h\ 
trash. h desktop. h 

disk.o  : $(H)  windows. h $(NAME).h  disk.h 

edlt.o  : $(H)  windows. h $(NAME).h  resource. h desktop. h clipbrd.h  edit.h 

event. o : $(H)  windows. h desktop. h menu.h  event. h 

gemain.o  : $(H)  windows. h initerm.h  event. h gemain.h 

global. 0 : $(H) 

graf.o  : $(H)  windows. h $(NAME).h  graf.h 

image. o : $(H)  windows. h $(NAME).h  resource. h clipbrd.h  image. h 

initerm.o  : $(H)  windows. h $(NAME) .h  resource. h menu.h  event. h desktop. h\ 

trash. h disk.h  printer. h edit.h  clipbrd.h  image. h meta.h  graf.h\ 
power. h initerm.h 

raenu.o  : $(H)  windows. h $(MME).h  desktop. h graf.h  power. h resource. h menu.h 

meta.o  : $(H)  windows. h $(NAME).h  resource. h clipbrd.h  meta.h 

power. o : $(H)  windows. h $(NAME).h  power. h 

printer.©  : $(H)  windows. h $(NAME).h  printer. h 

rcm.o  : rcm.h 

resource.©:  $(H)  $(NAME).h  resource. h 

trash. o : $(H)  windows. h $(NAME).h  desktop. h clipbrd.h  trash. h 
windows.©  : $(H)  windows. h 
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- Lattice  C 


Datel  SCEmP.LNK: 

* 

* Standard  control  file  for  linking  Lattice  C modules. 

* 

* Step  1 - initialisation 
« ======================= 

* 

* C initialisation  must  be  included  first. 

* 

INPUT  startup.bin 
* 

* Step  2 - user  modules 


* 

* Now  Include  a single  user  module 
» (from  the  command  line). 

* INPUT  » 

INPUT  cllpbrd.bin 
INPUT  desktop.bin 
INPUT  disk. bln 
INPUT  edit.bin 
INPUT  event.bin 
INPUT  gemain.bin 
INPUT  global.bin 
INPUT  graf.bin 
INPUT  image.bin 
INPUT  initerm.bin 
INPUT  menu.bin 
INPUT  meta.bin 
INPUT  power.bin 
INPUT  printer.bin 
INPUT  rcm.bin 
INPUT  resource.bin 
INPUT  trash.bin 
INPUT  windows.bin 

* 

* For  each  extra  module  you  weuit  to  Include  in  the 
» link  include  a line  of  the  form; 

* 

* INPUT  <flle  name> 

* 

* Step  3 - floating  point  library 
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« = = = = = = = = = = = = = = = = = = = = = = = = = = = :;  = = = 

» Comment  out  this  line  If  your  program  does  not  use 

* floating  point 

* 

LIBRARY  fplib.bin 

» Step  4 - C library 
* ================== 

* 

* C library  - must  always  be  included. 

* 

LIBRARY  clib.bin 
* 

* Step  5 - GEM  graphics  library 

* ============================= 

* 

* GEM  graphics  library  - only  Include  if  your  program 
» is  trying  to  access  graphics  routines 

» (by  uncommenting  the  line) . 

* 

LIBRARY  gemlib.bin 
* 


- Mark  Williams  C 
Datei  MAKEFILE: 

####  MAKEFILE  fQr  SCRAP  #*## 


NAME  = scrap 


CFUGS  = -VPEEP 

LFLAGS  = -X  -s  -laes  -Ivdi 


APP 


•prg 
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H = import. h export. h global. h 


OBJS  = clipbrd.o  desktop. o disk.o  edit.o  event. o gemain.o  global. o graf.oX 
image. o initerm.o  menu.o  meta.o  power. o printer. o rcm.o  resource. o\ 
trash. o windows.© 

$(NAME)$(APP):  $(0BJS) 

$(CC)  $(OBJS)  $(LFLAGS)  -o  $@ 


clipbrd.o  : 

desktop. o : 

disk.o  ; 
edit.o  : 
event. o : 
gemain.o  : 
global. o : 
graf.o  : 
image. o : 
initerm.o  : 


menu.o 
raeta . o 
power. o 
printer. o 
rcm.o 

resource. o 
trash . o 
windows.© 


${H)  windows. h $(NAME).h  resource. h desktop. h edit.h  image. h\ 
meta.h  trash. h clipbrd.h 

$(H)  windows. h $(NAME).h  clipbrd.h  disk.h  event. h menu.h  printer. h 

trash. h desktop. h 

$(H)  windows. h $(NAME).h  disk.h 

windows. h $(MME).h  resource. h desktop. h clipbrd.h  edit.h 
windows. h desktop. h menu.h  event. h 
windows. h initerm.h  event. h gemain.h 


m) 

$(H) 

$(H) 

$(H) 

$(H) 

$(H) 

$(H) 


windows. h $(NAME) .h  graf.h 

windows. h $(NAME).h  resource. h clipbrd.h  Image. h 
windows. h $(NAME) .h  resource. h menu.h  event. h desktop. h\ 
trash. h disk.h  printer. h edit.h  clipbrd.h  image. h meta.h  graf.hX 
power. h initerm.h 

1(H)  windows. h $(NAME) .h  desktop. h graf.h  power. h resource. h menu. 

$(H)  windows. h $(NAME) .h  resource. h clipbrd.h  meta.h 

$(H)  windows. h $(NAME) .h  power. h 

$(H)  windows. h $(NAME).h  printer. h 

rcm.h 

$(H)  $(NAME) .h  resource.h 

$(H)  windows. h $(NAME).h  desktop. h clipbrd.h  trash. h 
$(H)  windows. h 
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M(Ae-  und  Projekt-Dateim 
- Turbo  C 


Datei  SCRAP. PR J: 


; SCRAP. PRJ 


.C[-W-par  -W-slg] 

= ; list  of  modules  follows 

testart.o  ; startup  code 

clipbrd  (global. h,  windows. h,  scrap. h,  resource. h,  desktop. h,  edit.h, 

image. h,  meta.h,  trash. h,  clipbrd. h) 

desktop  (global. h,  windows. h,  scrap. h,  clipbrd. h,  disk.h,  event. h, 

menu.h,  printer. h,  trash. h,  desktop. h) 
disk  (global. h,  windows. h,  scrap. h,  disk.h) 

edit  (global. h,  windows. h,  scrap. h,  resource. h,  desktop. h,  clipbrd. h, 

edit.h) 

event  (global. h,  windows. h,  desktop. h,  raenu.h,  , event. h) 

gemaln  (global. h,  windows. h,  initerm.h,  event. h,  gemain.h) 

global  ( global. h) 

graf  (global. h,  windows. h,  scrap. h,  graf.h) 

image  (global. h,  windows. h,  scrap. h,  resource.h,  clipbrd. hj  image. h) 

Initerm  (global. h,  windows. h,  scrap. h,  resource.h,  menu.h,  event. h, 

desktop. h,  trash. h,  disk.h,  printer. h,  edit.h,  clipbrd. h, 
image. h,  meta.h,  graf.h,  power. h,  initerm.h) 
menu  (global. h,  windows. h,  scrap. h,  desktop. h,  graf.h,  power. h, 

resource.h,  menu.h) 

meta  (global. h,  windows. h,  scrap. h,  resource.h,  clipbrd. h,  meta.h) 

power  (global. h,  windows. h,  scrap. h,  power. h) 

printer  (global. h,  windows. h,  scrap. h,  printer. h) 

rcm  (rcm.h) 

resource  (global. h,  scrap. h,  resource.h)  [-W-rpt]  ' 

trash  (global. h,  windows. h,  scrap. h,  desktop. h,  clipbrd. h,  trash. h) 

windows  ( global. h,  windows. h) 

tcfltlib.llb  ; floating  point  lib 

testdlib.llb  ; standard  lib 

tcextllb.lib  ; extended  lib 

tctosllb.lib  ; TOS  lib 

tcgerallb.lib  ; AES  and  VDI  lib 
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b)  MSDOS 
- Microsoft  C 
Date!  MK.BAT: 
make  makefile 


Datei  MAKEFILE: 

NAME  = scrap 

############################################# 

CFLAGS  = -AL  -Oas  -Gs 

LFLAGS  = /ST: 12288  /^E:512  /NOI  /E 

APP  = . app 

.c.obj: 

cl  -c  $(CFLAGS)  $*.c 

.asm. Ob j : 

masm  /Mx  $*; 


H = $*.c  $*.h  Import. h export. h global. h 

OBJS  = clipbrd.obj  desktop. obj  disk.obj  edit.obj  event. obj  gemain.objX 
global. obj  graf.obj  image. obj  initerm.obj  menu. obj  meta.objX 
power. obj  printer. obj  rcm.obj  resource. obj  trash. obj  windows. obj 

clipbrd.obj  : $(H)  windows. h $(NAME) .h  desktop. h edit.h  image. h meta.h  trash. h 

desktop. obj  : $(H)  windows. h $(NAME) .h  disk.h  event. h raenu.h  printer. h trash. h' 
clipbrd.h 
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disk.obj  : $(H)  windows. h $(NAME).h 

edlt.obj  : $(H)  windows. h $(NAME).h 

event. obj  : $(H)  windows. h desktop. h 

gemain.obj  : $(H)  initerm.h  event. h 

global. obj  : $(H) 

graf.obj  : $(H)  windows. h $(NAME).h 

image. obj  : $(H)  windows. h $(NAME).h 

initerm.obj  ; $(H)  windows. h $(NAME).h 

trash. h disk.h  pr inter. h 
power. h 

menu. obj  : $(H)  windows. h $(NAME).h 

meta.obj  : $(H)  windows. h $(NAME).h 

power. obj  : $(H)  windows. h $(NAME).h 

printer. obj  ; $(H)  windows. h $(NAME) .h 

rcm.obj  : $(H) 

resource . Ob j : 5(H)  $(NAME) .h 
trash. obj  ; $(H)  windows. h $(NAME).h 

windows. obj  ; $(H) 


5(NAME)5(APP)  : $(0BJS) 

link  $(LFLAGS)  @$(NAME).lnk 


resource. h desktop. h clipbrd.h 
menu.h 


resource. h clipbrd.h 

resource. h menu.h  event. h desktop. h\ 
clipbrd.h  edit.h  image. h meta.h  graf.h\ 

desktop. h graf.h  power. h resource. h 
resource. h clipbrd.h 
resource. h 


desktop. h clipbrd.h 
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Datei  SCRAP. LNK: 

cllpbrd+ 

desktop+ 

disk+ 

edlt+ 

_pvent+ 

gemain+ 

global+ 

graf+ 

image+ 

inlterm+ 

menu+ 

meta+ 

power+ 

prlnter+ 

rcm+ 

resource+ 
trash+ 
windows 
scrap. app 

linscgera 


- Turbo  C 

Datei  BUILTINS . MAK : 
.c .obj  : 

tec  -c  $(CFLAGS) 

.asm. obj : 
tasm  /mx 


Datei  MAKEFILE: 

#####  MAKEFILE  fiir  SCRAP  ##### 

####**###################################################################### 


NAME  = scrap 


########*#########*#########*############################################### 
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CFLAGS  = -ml  -w-par 

LFLAGS  = /c  /X 

APP  = .app 

##################*##############################*##############*######*#### 
H = import. h export. h global. h 

OBJS  = clipbrd.obj  desktop. obj  disk.obj  edit.obj  event. obj  gemaln.obj\ 

global. Ob j graf.obj  image. obj  inlterm.obj  menu. obj  meta.objX  ' 
power. obj  printer. obj  rem.obj  resource. obj  trash. obj  windows. obj 


$( NAME) $( APP):  $(0BJS) 

tlink  $(LFLAGS)  @$(NAHE).lnk 

############################################################################ 


clipbrd.obj  : 

desktop. obj  : 

disk.obj  : 
edit.obj  : 
event . obj  : 
gemain.obj  : 
global . obj  : 
graf.obj  : 
image. obj  : 
initerm.obj  : 


menu . obj 

meta.obj 
power . obj 
printer . obj 
rem.obj 
resource. obj 
trash. obj 
windows. obj 


$(H)  windows. h $(NAME) .h  resource. h desktop. h edit.h  image. h\ 
meta.h  trash. h clipbrd.h 

$(H)  windows. h $(NAME).h  clipbrd.h  disk.h  event. h menu.hX 
pr inter. h trash. h desktop. h 


$(H) 

$(H) 

$(H) 

1(H) 

$(H) 

$(H) 

$(H) 

$(H) 


windows. h $(NAME).h  disk.h 

windows. h $(NAME).h  resource. h desktop. h clipbrd.h  edit.h 
windows. h desktop. h menu.h  event. h 
initerm.h  event. h geraain.h 


windows. h $(NAME) .h  graf .h 

windows. h $(NAME) .h  resource. h clipbrd.h  image. h 
windows. h $(NAME).h  resource. h menu.h  event. h desktop. h\ 
trash. h disk.h  printer. h edit.h  clipbrd.h  image. h meta.h  graf.hX 
power. h initerm.h 

$(H)  windows. h $(NAME).h  desktop. h graf.h  power. h resource. h\ 
menu.h 

$(H)  windows. h $(NAME).h  resource. h clipbrd.h  meta.h 
$(H)  windows. h $(NAME).h  power. h 
$(H)  windows. h $(NAME) .h  printer. h 
rcm.h 


$(H)  $( NAME) .h  resource. h 

$(H)  windows. h $(NAME).h  desktop. h clipbrd.h  trash. h 
$(H)  windows. h 
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Datel  SCRAP. LNK: 

c;\tc\lib\c01+ 

clipbrd+ 

desktop+ 

dislc+ 

edit+ 

event+ 

geraain+ 

global+ 

graf+ 

image+ 

inlterm+ 

menu+ 

meta+ 

power+ 

prlnter+ 

rcm+ 

resource+ 

trash+ 

windows 

scrap.app 

c:\tc\lib\ltcgem+c;\tc\lib\mathl+c:\tc\lib\eniu+c:\tc\lib\cl 


Datel  SCRAP. PR J: 


cllpbrd 

desktop 

disk 

edit 

event 

gemaln 

global 

graf 

Image 

Inlterm 


menu 

meta 

power 


(global. h,  windows. h,  scrap. h,  resource. h,  desktop. h,  edlt.h, 
image. h,  raeta.h,  trash. h,  cllpbrd. h) 

(global. h,  windows. h,  scrap. h,  cllpbrd. h,  disk.h,  event. h, 
menu.h,  printer. h,  trash. h,  desktop. h) 

( global. h,  windows. h,  scrap. h,  disk.h) 

scrap. h,  resource. h,  desktop. h,  cllpbrd. h 


( global. h,  windows. h, 
edlt.h) 

(global. h,  windows. h,  desktop. h,  menu.h,  event. h) 

initerm.h,  event. h,  gemain.h) 


( global. h,  windows. h, 
( global. h) 

( global. h,  windows. h, 
( global. h,  windows. h, 
( global. h,  windows. h, 


scrap. h,  graf.h) 

scrap. h,  resource. h,  clipbrd.h,  image. h) 
scrap. h,  resource. h,  menu.h,  event. h, 
desktop. h,  trash. h,  disk.h,  printer. h,  edlt.h,  clipbrd.h, 
Image. h,  meta.h,  graf.h,  power. h,  Initerm.h) 

( global. h,  windows. h,  scrap. h,  desktop.h,  graf.h,  power. h, 
resource.h,  menu.h) 

( global. h,  windows. h,  scrap. h,  resource.h,  clipbrd.h,  meta.h) 
(global. h,  windows. h,  scrap. h,  power. h) 
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printer 

rcni 

resource 

trash 

windows 

Itcgem.lib 


(global. h,  windows. h,  scrap. h,  printer. h) 

(rcra.h) 

(global. h,  scrap. h,  resource. h) 

(global. h,  windows. h,  scrap. h,  desktop. h,  clipbrd.h,  trash. h) 
( global. h,  windows. h) 


Dated  TURBOC.CFG: 


-ml 

-Ic:\tc\include 

-Lc:\tc\lib 


c)  FlexOS 
- High  C 
Dated  MAKEFILE: 

#####  MAKEFILE  fur  SCRAP  ##### 


NAME  = scrap 


CFLAGS  = -Off  Prototype_overwrite_warnings  -On  PCC_msgs 
LFUGS  = 

APP  = .286 


COMPILE  = he  $*.c  $( CFLAGS) 


H = import. h export. h global. h 

OBJS  = clipbrd.obj  desktop. obj  disk.obj  edit.obj  event. obj  gemain.objX 
global. obj  graf.obj  image. obj  inlterm.obj  menu. obj  meta.objX 
power. obj  printer. obj  rcm.obj  resource. obj  trash. obj  windows. obj 
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###*##############################*########*#####*#############*############ 

$(NAME)$(APP) : $(OBJS)  - 

link86  $(LFLAGS)  $(NAME) . lnp[l]  ' V.,,,.,.,. 

##*#######################################################*################# 

clipbrd.obj  : clipbrd.c  clipbrd.h  windows. h $(NAME).h  resource. h desktop. h\ 
edlt.h  image. h meta.h  trash. h 

$( COMPILE) 

desktop. obj  : desktop. c desktop. h windows. h $(NAME) .h  disk.h  event. h menu.hX 
printer. h trash. h clipbrd.h 

$ (COMPILE)  , 

disk. obj  : disk.c  disk.h  windows. h $(NAME).h 
$( COMPILE) 

L I 

edit. obj  : edit.c  edit.h  windows. h |(NAME) .h  resource. h desktop. h clipbrd.h 
$ (COMPILE) 


event . obj  : 

$ (COMPILE) 

gemain.obj  : 
$( COMPILE) 

global. obj  : 
$( COMPILE) 

graf.obj  : 

$( COMPILE) 

image . obj  : 

$( COMPILE) 

initerm.obj  : 


event. c event. h windows. h desktop. h menu.h 
gemaln.e  gemaln.h  inlterm.h  event. h t..''; 


global. c global. h 


if..':  ;i 


r i? 


graf.c  graf.h  windows. h $(NAME).h 

image. c image. h windows. h $(NAHE).h  resource. h clipbrd.h 


initerm.c  inlterm.h  windows. h $(NAME).h  resource. h menu.hX 
event. h desktop. h trash. h disk.h  printer. h clipbrd.h  edit.hX 
image. h meta.h  graf.h  power. h 


$( COMPILE) 


menu. obj  : menu.c  menu.h  windows. h $(NAME).h  desktop. h graf.h  power. h\ 
resource. h 


$( COMPILE) 


k.Ht  1. 


meta.obj  : meta.c  meta.h  windows. h $(NAME).h  resource, h clipbrd.h 
^(COMPILE)  ; - 


power. obj  ; power. c power. h windows. h $(NAME).h  resource. h 
$(COMPILE)  w...  ,.v  - --.v,,,.  ...  ...  , 
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printer. obj  ; printer. c printer. h windows. h $(NAME).h 
$( COMPILE) 

rcm.obj  : rcm.c  rcm.h 
$(C0MPILE) 

resource . obj : resource. c resource. h $(NAME).h 
$(C0MPILE) 

trash. obj  : trash. c trash. h windows. h $(NAME) .h  desktop. h clipbrd.h 
$(COMPILE) 

windows. obj  : windows. c windows. h 
$(COMPILE) 


Datei  SCRAP. IMP 

scrap[stack[add[4000]]]  = 

xgemb ig . 186 [nose , li] , 

clipbrd, 

desktop, 

disk, 

edit, 

event, 

gemain, 

global, 

graf, 

image, 

initerm, 

menu, 

meta, 

power, 

printer, 

rcm, 

resource, 

trash, 

windows, 

xgemsrtl.l86[s,li] , 
dosrtl.l86[s,li] , 
hcbe.l86[s,li] 

Datei  SCRAP. PRF 


Graphics  Mode  = True 
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Anhang  C 


Die  neue  Software 


Seit  cler  Erstauflage  dieses  Buches  ist  nunmehr  etwa  ein  Jahr  verstrichen.  Das 
Demoprogramm  zum  Buch  (SCRAP)  wurde  standig  weiterentwickelt  und  liegt 
nun  in  einer  iiberarbeiteten  Version  vor.  Zunachst  einige  Schlagworte  zu  den 
wesentlichen  Anderungen. 

- Unterstutzung  beider  Mausknbpfe  * ' > ^ ..  . ■ j 

- modale  und  nicht-modale  Dialogboxen  in  echten  Fenstern  ' * 

- erweiterte  Alerlboxen  in  cchlen  Fenstern  v .,|  ;f  , , r i i 

- blinde  PaBwort-Eingabe  ‘‘  nuj  - 

- Unterstutzung  der  TOS  1.4  Filc-Sclector-Box  V"  ‘ ■ ir  ■ " .'v 

- Listboxen  in  Dialogboxen 

AuBerdem  wurden  viele  Kleinigkeiten  verbessert,  von  denen  die  meisten  durch 
die  folgenden  Erlauterungen  klar  werden  diirften.  ? 

Die  Compiler  Digital  Research  C und  Lattice-C  werden  nicht  mehr  unterstiitzt, 
d.h.  nicht  mehr  getestet.  Dies  bedeutet  nicht,  daB  das  Programm  SCRAP  nicht  auch 
mit  diesen  Compilern  laufen  wiirde.  Beim  Digital  Research  Compiler  wurden  sich 
allerdings  Probleme  ergeben,  die  darauf  zuriickzufiihren  sind,  daB  die  Lange  der 
Bezeichner  auf  7 (fiir  externe  Bezeichner)  beschrankt  ist. 

Leider  muBten  wir  auch  feststellen,  daB  die  modalen  und  nicht-modalen  Fenster 
mit  dem  Megamax  Laser  C Compiler  nicht  richtig  funktionieren,  wenn  sie  editier- 
bare  Felder  beinhalten.  Offensichtlich  sind  die  dafiir  notwendigen  und  selten 
benutzten  GEM-Bindings  "objc_edit",  "form_keybd"  und  "form_button"  nicht 
richtig  implcmentiert.  Arbeitet  man  mit  diesem  Compiler,  muB  man  also  auf  die 
gcnanntcn  Features  verzichten.  Da  aber  auch  die  benutzerdefinierbaren  Objekte 
mit  diesem  Compiler  nicht  laufen  konnen,  ist  ein  Umsteigen  auf  einen  anderen 
Compiler  sinnvoll. 

Der  Turbo  C Compiler  wird  ab  der  Version  2.0  unterstiitzt.  Es  soil  noch  erwahnt 
werden.  daB  das  Stack  Checking  ausgeschaltet  sein  muB  (wegen  der  benutzerde- 
finierten  Objekte)  und  absolute  Calls  benutzt  werden  miissen.  AuBerdem  sollten 
Zeichenketten  nicht  zusammengelegt  werden,  also 


540 


Anhang  C . Die  neue  Software 


-T  aus 

P an 

M an 


Im  folgenden  wird  erlautert,  welche  wesentlichen  Anderungen  die  einzelnen 
Module  erfahren  haben. 


Modul  GLOBAL 


Folgende  Konstanten-Definitionen  wurden  aufgenommen:  ' 

#define  FONT_SYSTEM  1 

#define  FONTISWISS  2 . . , , ,, 

#define  FONT.DUTCH  14  " 

Es  handelt  sich  um  den  System-Zeichensalz,  sowic  die  beiden  Zeichensatze,  die 
von  Digital  Research  zum  GEM/3  mitgeliefert  werden.  Die  Konstanten  kdnnen 
bei  einem  Aufruf  von  ”vst_font”  benutzt  werden. 

#define  POS 1 
#define  PGUP 
#dcl'ine  ENDKEY 
#define  PGDOWN 
#define  CNTRL_LEFT 
#define  CNTRL_R1GHT 

Die  ersten  vier  Definitionen  bezeichnen  die  Scan-Codes  der  Tasten  eines  AT-Key- 
boards,  die  beim  Atari  ST  nicht  vorhanden  sind.  Die  beiden  letzten  Definitionen 
wurden  aufgenommen,  da  die  Pfeiltasten  mit  gedriickter  Control-Taste  einen 
anderen  Scan-Code  liefem. 

#define  UNDO_FLAG  0x0200  ' f > a:;:  v 4 

#define  HELP_FLAG  0x0400  ■ ^ ;;  r > cr;  ' ur; 

#define  NOECHO_FLAG  0x0800 

Die  drei  Flags  werden  zusatzlich  zu  den  OB_FLAGS  eines  Objektes  benutzt.  Da 
sie  nicht  interaktiv  im  Resource-Construction-Set  eingegeben  werden  kdnnen, 
werden  sie  im  Module  RESOURCE  "zu  FuB"  gesetzt  (siehe  Modul  RESOURCE). 

Das  UNDO-Flag  gibt  an,  welcher  Knopf  (Button)  eincr  Dialogbox  mit  der  UN- 
DO-Taste  aufgerufen  wird,  falls  diese  Taste  vorhanden  ist. 

Das  HELP -Flag  gibt  an,  welcher  Knopf  (Button)  einer  Dialogbox  mit  der  HELP- 
Taste  aufgerufen  wird,  falls  diese  Taste  vorhanden  ist.  Im  Programm  wird  die 
Funktionstaste  FI  zur  zusatzlichen  Help-Taste. 

Das  NOECHO-Flag  gibt  an,  welches  editierbarc  Objekt  eincr  Dialogbox  kein 
Echo  haben  soil.  In  ein  solches  Objekt  werden  dann  anstatl  Buchslabcn  ’*’-Sym- 
bole  ausgegeben.  Dies  dient  z.B.  zur  Eingabe  von  PaBwdrtern.  Ein  Beispiel  wird 
im  Modul  MENU  gegeben.  Die  dort  zu  dffnende  Dialogbox  fur  die  Systemeinstel- 
lungen  beinhaltet  auch  ein  PaBwort.  Wcitcrc  Informationen  wird  in  der  Beschrei- 
bung  zur  Funktion  "edit_noecho"  gegeben. 


0x47 

0x49 

0x4F  ' 

Ox  .51 

0x73  , 

0x74 
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typedef  BYTE  HUGE  *HPTR; 
typedef  BYTE  FAR  *FPTR; 

Die  beiden  Typdefinitionen  sind  unter  MS-DOS  zu  verwenden.  Dort  stellen  sie 
Huge-Pointer  bzw.  Ear-Pointer  dar. 

typedef  struct 
{ 


WORD  momask; 

} MKINFO; 

In  der  Struktur  MKINFO  (Mouse-Keyboard-Info)  ist  ein  Element  dazugekommen. 
Es  handelt  sich  um  die  Komponente  "momask".  Sie  gibt  die  Maske  des  Mausknop- 
fes  an,  der  ein  Ereignis  ausgelost  hat.  Friiher  wurde  nur  die  Komponente  "mobut- 
ton"  zu  Hilfe  genommen.  Da  nun  zwei  Mausknopfe  unterstiitzt  werden,  benotigt 
man  zusatzliche  Information,  da  man  aus  der  Belegung  der  Komponenten  "mobut- 
ton"  mit  der  Zahl  0 (bei  Mausknopf  oben)  nicht  erkennen  kann,  welcher  Maus- 
knopf  nun  oben  ist. 

"momask"  kann  folgende  Werte  annehmen: 

0x0001  : linker  Mausknopf  hat  Ereignis  ausgelost 
0x0002  : rechter  Mausknopf  hat  Ereignis  ausgelost 

"mobutton"  nimmt  nach  wie  vor  folgende  Werte  an: 

0x0000  : Mausknopfe  oben 
0x0001  : linker  Mausknopf  unten 
0x0002  : rechter  Mausknopf  unten 


Damit  ergeben  sich  zur  Unterscheidung  der  einzelnen  Ereignisse  folgende  Werte; 


Ereignis 

momask 

mobutton 

Klick  links 

0x0001 

0x0000 

Drag  links 

0x0001 

0x0001 

Klick  rechts 

0x0002 

0x0000 

Drag  rechts 

0x0002 

0x0002 

Klick  bedeutet,  daB  der  Mausknopf  sofort  wieder  losgelassen  wird.  Drag,  daB  der 
Mausknopf  gedriickt  gehalten  wird.  Wird  ein  Mausknopf  gedriickt,  wird  vom 
Modul  EVENT  auf  ein  Loslassen  desselben  gewartet,  so  daB  ein  durchgehendes 
Driicken  nur  ein  Ereignis  ausldst.  Soli  dies  verhindert  werden,  so  muB  in  der 
Routine,  die  dieses  Ereignis  verarbeitet,  der  Wert  der  Variablen  "bclicks"  auf 
0x102  gesetzt  werden  (siehe  auch  Modul  DESKTOP,  Routine  "wi_click"). 
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GLOBAL  WORD  gLpoint; 

Die  PunktgroBe  des  Systemzeichersatzes,  Sie  kann  z.B.  in  einem  Aufruf 
''vst__point"  benutzt  werden,  Im  allgemeinen  hat  sie  den  Wert  10.  Auf  dem  Atari 
ST  in  mittlerer  oder  ntedriger  Aufldsung  hat  sie  beispielsweise  den  Wert  9. 

GLOBAL  WORD  mousenumber; 

Die  aktuelle  Nummer  der  Mausform.  Wird  z.B.  im  Modul  DIALOG  benutzt,  um 
nach  der  Behandlung  einer  modalen  Dialogbox  die  urspriingliehe  Mausform 
wiederherzustellen. 

GLOBAL  MFORM  *mouseform; 

Die  aktuelle  Form  der  Maus,  falls  "mousenumber"  den  Wert  USER_DEF  hat.  i 
GLOBAL  BOOLEAN  updtmenu; 

Flag,  welches  angibt,  ob  nach  einem  Ereignis  die  Menus  auf  den  neuesten  Stand 
gebracht  werden  sollen.  Normalerweise  ist  dies  der  Fall,  da  nach  einem  Ereignis 
meist  ein  Zustand  eintritt,  der  Mentis  verandert  bzw.  Meniieintrage  ein-  oder 
ausschaltet.  Wird  die  Variable  von  einer  Routine  auf  FALSE  gesetzt,  so  wird  beim 
nachsten  Durchgang  das  Menu  nicht  auf  den  neuesten  Stand  gebracht. 

Der  Sinn,  der  dahinter  steckt  ist  einfach  der,  Zeit  zu  sparen,  da  die  Funktion 
"updt_menu"  oft  aufgerufen  wird  und  etwas  Zeit  kostet.  Im  Normalfall  macht  sich 
dies  aber  nicht  bemerkbar. 

Einige  Funktionen  des  Moduls  WINDOWS  setzen  die  Variable  auf  FALSE,  da  sich 
kein  Menii  andem  kann.  So  wird  dies  z.B.  beim  Verschieben  eines  Fensters  gctan 
Oder  wenn  eine  Taste  in  einem  editierbaren  Objekt  in  einer  Dialogbox  gedriickt 
wird,  die  sich  in  einem  Fenster  befindet.  Dabei  andert  sich  der  Zustand  des 
Programmes  im  Normalfall  nicht. 

GLOBAL  BYTE**  alerts;  /v-.i 

Die  Variable  enthalt  eine  Tabelle  von  Zeigern  auf  die  Fehlermeldungen.  Fehler- 
meldungen  werden  nicht  mehr  im  Resource-Construction-Set  angegeben,  da  sie 
dann  nicht  flexibel  genug  sind.  Die  Fehlerbehandlung  wird  noch  weiter  unten 
erklart. 

BOOLEAN  is_state  (OBJECT  *tree,  WORD  obj,  DWORD  state); 

Es  wird  gepriift,  ob  ein  bestimmter  Status  (z.B.  SELECTED)  eines  Objektes 
(ob_state)  gesetzt  ist. 

is_state  : TRUE,  wenn  der  gepriifte  Status  gesetzt  ist,  sonst  FALSE  • .‘-vv, 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objckts  ■ ■ ■ ' > i.;.-'- 

state  : Status,  der  gepriift  werden  soli  ' ■ 

BOOLEAN  is_flags  (OBJECT  *tree,  WORD  obj,  DWORD  Hags); 

Es  wird  gepruft,  ob  cin  bestimmtes  Flag  (z.B.  SELECTABLE)  eines  Objektes 
(ob_flags)  gesetzt  ist. 
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is_flags  ; TRUE,  wenn  das  gepriifte  Flag  gesetzt  1st,  sons!  FALSE 


tree 

: Zeiger  auf  einen  Objektbaum 

obj 

: Index  des  Objekts 

flags 

: Flag,  welches  gepriift  werden  soil 

WORD  find_type  (OBJECT  *tree,  WORD  obj,  UWORD  type);  , 0;O  ' 

Sucht  ein  Objekt  eines  bestimmten  Typs  in  einem  Objektbaum. 

find_type  ; Index  des  gesuchten  Objekts  im  Objektbaum  oder  NIL,  wenn 

kein  solches  Objekt  gefunden  wurde 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  ersten  zu  untersuchenden  Objekts  , , , l > . 'uv 

type  ; Typ,  den  das  gesuchte  Objekt  haben  soil 

VOID  set_checkbox  (OBJECT  *tree,  WORD  obj,  BOOLEAN  selected); 

Der  Status  SELECTED  eines  Objekts  (Checkbox)  wird  gesetzt  oder  zuriickgesetzt. 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objekts 

selected : 1st  der  Wert  TRUE,  wird  der  Status  SELECTED  gesetzt,  sonst 
zuriickgesetzt 

BOOLEAN  get„checkbox  (OBJECT  *trce,  WORD  obj);  . ^ ^ 

Liefert  den  Status  eines  Objekts  (Checkbox), 

get_checkbox  : TRUE,  wenn  der  Status  SELECTED  gesetzt  ist,  sonst  FALSE 
tree  : Zeiger  auf  einen  Objektbaum 

obj  ; Index  des  Objekts 

VOID  set_rbutton  (OBJECT  *tree,  WORD  obj,  WORD  lower,  WORD  upper); 

Der  Status  SELECTED  einer  Gruppe  von  Objekten  (Radio-Buttons)  wird  gesetzt 
Oder  zuriickgesetzt.  Dabei  wird  ein  Objekt  selektiert,  alle  anderen  deselektiert. 

tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  Objekts,  welches  selektiert  werden  soil 

lower  : Index  des  ersten  Objekts  (Radio-Buttons)  i - , . . . 

upper  : Index  des  letzten  Objekts  (Radio-Buttons) 

WORD  get_rbutton  (OBJECT  *tree,  WORD  obj); 

Die  Objektnummer  eines  selektierten  Objekts  (Radio-Buttons)  einer  Gruppe  von 
Objekten  wird  geliefert.  Bei  Aufruf  der  Funktion  mu6  ein  Objekt  selektiert  sein. 

get_rbutton  : Index  des  ersten  gefundenen  selektierten  Objekts 
tree  : Zeiger  auf  einen  Objektbaum 

obj  : Index  des  ersten  Objekts,  ab  dem  gesucht  werden  soil 
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VOID  menu_check  (OBJECT  *tree,  WORD  obj,  BOOLEAN  checkit); 

Es  handelt  sich  um  die  gleiche  Funktion  wie  "menu_icheck",  welche  voiti  GEM 
bekannt  ist.  Der  Unterschied  besteht  nur  in  der  wesentlich  schnelleren  Ausfiihrung 
von  ”menu_check". 

VOID  menu_enable  (OBJECT  *tree,  WORD  obj,  BOOLEAN  enableit); 

Es  handelt  sich  um  die  gleiche  Funktion  wie  "menu_ienable",  welche  vom  GEM 
bekannt  ist.  Der  Unterschied  besteht  nur  in  der  wesentlich  schnelleren  Ausfiihrung 
von  "menu_enable".  Dies  macht  sich  vor  allem  in  der  Funktion  ”updt_menu'' 
bemerkbar,  die  viele  solche  Aufrufe  tatigt. 

VOID  objc_rect  (OBJECT  *tree,  WORD  obj.  RECT  *rect,  H'> 

BOOLEAN  calc_border);  ' 

Die  aktuellen  Koordinaten  des  Rechtecks,  das  ein  Objekt  umhiillt.  Das  Ergebnis 
bezieht  sich  auf  den  Koordinatenursprung  in  der  linken  oberen  Ecke  des  Bild- 
schirms  (x  = 0,  y = 0).  Es  kann  auBerdcm  angcgeben  werden,  ob  der  Rand  bei 
Objekten  des  Typs  G_BOX,  G_IBOX,  G_BOXCHAR  mit  beriicksichtigt  werden 
soil.  Zu  diesem  Rand  gehoren  auch  SHADOWED  und  OUTLINED. 

Zeiger  auf  einen  Objektbaum 
Index  des  Objekts 

Zeiger  auf  das  resultierende  Rechteck 
TRUE,  wenn  der  Rand  mit  beriicksichtigt  werden  soil,  sonst 
FALSE 

VOID  line_default  (WORD  vdi_handle); 

Setzt  Zeichenmodus  fiir  Linien  auf  einen  Standardwert.  Dieser  ist  gegeben  durch 
eine  schwarze,  durchgezogene  Linie  mit  quadratischen  Ecken  der  Starke  eins, 
welche  im  Replace-Modus  gezeichnet  wird. 

vdi_handle  : Handle  der  VDI-Arbeitsstation 
VOID  text_default  (WORD  vdi_handle); 

Setzt  Zeichenmodus  fiir  Text  auf  einen  Standardwert.  Dieser  ist  gegeben  durch 
normale  schwarze  Buchstaben  im  System-Zeichensatz,  die  von  links  nach  rechts 
im  Replace-Modus  gezeichnet  werden.  ^ 

vdi_handle  : Handle  der  VDI-Arbeitsstation 

' . A';  1 ■'  , 

VOID  v_text  (WORD  vdLhandle,  WORD  X,  WORD  y, 

BYTE  *string,  WORD  charwidth); 

Die  Funktion  ahnelt  der  VDI-Funktion  "v_gtext",  nur  daB  damit  auch  Texte  eines 
nichtproportionalen  Zeichensatzes  ausgegeben  werden  kdnnen,  welche  langer  als 
127  Zeichen  sein  konnen.  Dabei  muB  allerdings  die  Breite  eines  Zeichens  mit 
angegeben  werden. 

vdi_handle  : Handle  der  VDI-Arbeitsstation 

X : X-Koordinate  des  auszugebenden  Textes  * 


tree 

obj 

rect 

calc_border 


Modul  WINDOWS 


545 


y : Y-Koordinate  des  auszugebenden  Tcxies  4 - : *'  ; 4 

string  ; Zeiger  auf  den  auszugebenden  Text  ■ > ,,,i  ; 

charwidth  ; Breite  eines  Zeichens  (z.B.  gl_wbox) 

Die  Funktion  "open_dial"  wurde  in  "opendial"  utnbenannt,  da  es  eine  neue  Funk- 
tion  "open_dialog"  gibt. 

Die  Funktion  "close_diar'  wurde  in  "closedial"  umbenannt. 

Die  Funktion  ”mem_free"  liefert  kein  Ergebnis  mehr  zuriick,  da  dies  nicht  in  alien 
Systemumgebungen  garantiert  wird. 


BOOLEAN  selecl_file  (BYTE  *name,  BYTE  *path,  BYTE  *suffix, 
BYTE  *label,  BYTE  *filcname); 


Mit  Hilfe  dcr  Datciauswahl-Box  von  GEM  kann  eine  Datei  gewahlt  werden.  Dabei 
kann  ein  Standard-Name  (z.B.  NAMENLOS.DOC)  sowie  ein  Suffix  angegeben 
werden  (z.B.  "*.DOC”).  Ab  TOS  1.4  kann  aueh  ein  Label  angegeben  werden. 
Unterstutzt  die  GEM- Version  dies  nicht,  wird  das  Label  ignoriert. 


select_file 

name 

suffix 

label 

filename 


: TRUE,  wenn  eine  Datei  ausgewahlt  und  OK  gewahlt  wurde, 
sonst  FALSE 

: Zeiger  auf  einen  Dateinamen  dcr  als  Defaull-Namen  angeboten  wird 
: Zeiger  auf  ein  Suffix,  welches  als  Default-Suffix  angeboten  wird 
; Zeiger  auf  eine  Zeichenkette,  die  als  Beschriftung  dient 
: Resultierender  kompletter  Dateiname 


Bei  dieser  Funktion  werden  auch  die  globalen  Variablen  "fs_path",  "fs_ser  und 
"fs_bulton"  gesetzt.  1st  der  Parameter  "suffix"  nicht  leer,  so  wird  er  in  die  Datei- 
auswahl-Box  gesetzt,  ansonsten  wird  das  zuletzt  eingestclltc  Suffix  benutzt. 

1st  der  Parameter  "name"  nicht  leer,  so  wird  er  in  die  Dateiauswahl-Box  gesetzt, 
ansonsten  wird  der  zuletzt  gewahlte  Name  nicht  verandert. 


Wird  zwar  der  OK-Knopf  gewahlt,  aber  keine  Datei  spezifiziert,  so  hat  dies 
dieselbe  Wirkung  wie  das  Wiihlen  des  Abbruch-Knopfes. 

Die  Funktion  ”is_menu_key"  wurde  modifiziert.  Das  Zeichen  fiir  Shift  ist  nun 
nicht  mehr  ”s",  sondern  der  Pfeil  nach  oben.  Menukiirzel  sollten  also  entsprechend 
angepaBt  werden. 


Modul  WINDOWS 

In  diesem  Modul  hat  sich  einiges  getan.  Dies  belegt  schon  die  Tatsache,  daB  knapp 
40  KB  Quellcode  dazugekommen  sind. 

Zunachst  wurden  die  Window-Flags  erweitert.  Es  bedeuten: 

WI_LOCKED:  Das  Fenster  ist  gesperrt.  Dieses  Elag  wird  intern  benutzt,  wenn 
modale  Dialogboxen  aufgerufen  werden. 
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WI_FIRSTDRW:  Das  Fenster  wurde  zum  erstenmal  gezeichnet.  Dieses  Flag  wird 
intern  benutzt,  wcnn  einc  Dialogbox  in  einem  Fenster,  welches  noch  nicht  gezeich- 
net wurde,  bereits  einen  Mausklick  erhiilt. 


WI_DLCLOSE;  Das  Fenster,  welches  eine  modalc  oder  nicht-modale  Dialogbox 
enthiiU,  soil  geschlossen  werden.  Dieses  Flag  wird  intern  benutzt,  wenn  der 
Anwender  auf  einen  EXIT-Knopf  in  einer  Dialogbox  gedriickt  hat.  Dann  wird  das 
Fenster  geschlossen.  Soil  dies  verhindert  werden,  wcil  beispielsweise  ein  Fehler- 
zustand  aufgetreten  ist,  so  dab  die  Dialogbox  noch  weiter  geoffnet  bleiben  soli, 
kann  dieses  Flag  zuriickgesetzt  werden.  Dies  wird  gewohnlich  in  der  Routine 
geschehen,  welche  auf  einen  Mausklick  in  der  Dialogbox  reagiert. 

WI_MODAL:  Das  Fenster  stellt  eine  modale  Dialogbox  dar.  Eine  niodale  Dialog- 
box  mub  zuerst  verlassen  werden,  bevor  das  Programm  seine  weiteren  Ausfiihrun- 
gen  fortsetzt.  Mehr  iiber  modale  Dialogboxen  folgt  in  der  Beschreibung  zum 
Modul  DIALOG. 

WI_MODELESS:  Das  Fenster  stellt  eine  nicht-modale  (modeless)  Dialogbox  dar. 
Eine  nicht-modale  Dialogbox  existiert  wie  ein  Fenster  parallel  zum  eigentlichen 
Programm.  Mehr  iiber  modale  Dialogboxen  folgt  in  der  Beschreibung  zum  Modul 
DIALOG. 


WI_CURSKEYS:  Das  Fenster  scrollt  automalisch,  wenn  die  Pfeiltasten  gedriickt 
werden.  Es  gelten  folgende  Tastenbelegungen: 


UP: 

Shift-UP  Oder  PGUP: 

LEFT: 

Shift-LEFT: 

RIGHT: 

Shift-RIGHT: 

DOWN: 

Shift-DOWN  Oder  PGDOWN: 
POSl  (HOME): 

END: 


Zeile  nach  oben  . , 

Seite  nach  oben 

Zeile  nach  links  ' . ; ■ ; 

Seite  nach  links 

Zeile  nach  rechts  ’ < h?:  . 

Seite  nach  rechts  i 

Zeile  nach  unten  . 'ri;,!. 

Seite  nach  unten 
Anfang  des  Dokumentes 
Ende  des  Dokumentes 


WI_MNSCROLL:  Das  Fenster  hat  einc  scrollbare  Meniizeile.  Ist  eine  Meniizeile 
in  ein  Fenster  eingeklinkt,  so  ist  sie  nicht  scrollbar,  wenn  dieses  Flag  nicht 
angegeben  wird.  Bei  kurzen  Meniizeilen  kann  auf  die  Pfeile  in  den  Mentis  verzich- 
tet  werden. 

WI_TOPMENU:  Das  Menu  des  Fensters  soli  nur  funktionieren,  wenn  das  Fenster 
ganz  oben  liegt.  Im  Normalfall  kann  auch  das  Menii  eines  unten  liegenden  Fensters 
mit  der  rechten  Maustaste  aktiviert  werden.  Bei  Fenstern,  die  bestimmte  Dinge 
nur  tun  kdnnen,  wenn  das  Fenster  oben  liegt,  kann  es  angebracht  sein,  mit  Hilfe 
dieses  Flags  zu  verhindern,  dab  das  Menii  bedient  werden  kann,  wenn  das  Fenster 
nicht  oben  liegt. 

Der  Window-Typ  wurde  ebenfalls  erweitert.  Er  bietet  5 neue  Komponenten: 


WORD  subclass; 

Die  Unterklasse  des  Fensters.  Es  handelt  sich  um  einen  weiteren  Bezeichner,  der 
Fenster  unterscheiden  kann.  Man  geht  davon  aus,  dab  man  zwei  Fenster  hat,  die 
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fast  das  gleiche  erledigen,  wobei  ein  Fenster  z.B.  nur  eingeschrankte  Fahigkeiten 
hat.  Dann  kbnnen  beide  Fenster  die  gleiche  Klasse  bekomrnen,  aber  verschiedene 
Unterklassen  besitzen.  Beim  Aufruf  von  ”create_window"  wird  die  Unterklasse 
gleich  der  Klasse  gesetzt.  Danach  kann  sie  von  der  Applikation  geandert  werden. 
Im  Code,  der  fur  beide  Fensterarten  gleich  ist,  konnen  nun  mit  Hilfe  der  "subcla.ss" 
die  Fahigkeiten  eines  Fensters  z.B.  eingeschrankt  werden. 

Urn  allc  Fenster  einer  Unterklasse  zu  bekomrnen,  kann  man  bei  "search_window’' 
und  bei  "num_windows"  zusatzlich  das  Flag  SRCH_SUB  angeben,  also  z.B. 

search_window  (CLASS_TRASH,  SRCH_OPENED  I SRCH_SUB,  NIL);  '' 

Der  Aufruf  sucht  alle  Papieikorbfenster  der  Unterklasse  CLASS_TRASH.  Die 
Klasse  des  Papierkorbs  kann  z.B,  CLASS_L1ST  sein,  weil  der  Papierkorb  als  Liste 
dargestellt  wird. 

WORD  bg_color; 

Die  Hintergrundfarbe  eines  Fensters  kann  gesetzt  werden.  Dann  wird  der  Hinter- 
grund  des  Fensters  beim  Offnen  noch  vor  der  ersten  REDRAW-Message  in  dieser 
Farbe  gezeichnet.  Voreingestellt  ist  WHITE.  Zum  Unterdriicken  des  Zeichnens 
mu6  eine  Zahl  kleiner  0 (z.B.  -1)  angegeben  werden. 

WORD  edit_obj; 

Beinhaltet  das  aktuelle  Objekt,  in  welchem  sich  der  Cursor  befindet,  wenn  eine 
module  Oder  nicht-modale  Dialogbox  in  einem  Fenster  nach  oben  kommt.  1st  der 
Wert  <=  0,  so  befindet  sich  kein  editierbares  Objekt  in  dieser  Dialogbox,  Vor 
jedem  Offnen  einer  Dialogbox  sollte  der  Wert  auf  das  erste  editierbare  Objekt 
gesetzt  werden. 

WORD  edit_inx;  i-: 

Aktueller  Index  im  editierten  Objekt,  d.h,  der  Buchstabe,  hinter  dem  der  Cursor 
steht.  Vor  jedem  Offnen  einer  Dialogbox  sollte  der  Wert  initialisiert  werden.  Dabei 
bedeutet  0,  dab  der  Cursor  sich  auf  dem  ersten  Buchstaben  befindet.  Wird  der  Wert 
auf  NIL  (-1)  gesetzt,  so  wird  der  Cursor  hinter  den  letzten  Buchstaben  gesetzt 
(Normalfall  in  GEM). 

WORD  exit_obj; 

Aktuelles  Objekt,  in  welches  in  einer  modalen  oder  nicht-modalen  Dialogbox 
geklickt  wurde.  Meistens  handelt  es  sich  um  einen  Button.  Istes  ein  EXIT-Button, 
so  wird  das  Flag  WI_DLCLOSE  gesetzt  und  die  Dialogbox  geschlossen.  Ausnah- 
men  hierzu  siehe  die  Erliiuterung  zum  Flag  WI_DLCLOSE.  Mil  Hilfe  von 
"edit_obj"  und  "exit_obj"  kann  bei  Auslosen  eines  Tastatur-  oder  Klick-Ereignis- 
ses  einer  Dialogbox  entsprechend  reagiert  werden  (siehe  Beispiel  weiter  unten), 

BOOLEAN  any_open  (BOOLEAN  incl_desk,  BOOLEAN  incl_closer, 
BOOLEAN  incl_modal); 

Es  kann  getestet  werden,  ob  irgendwelche  Fenster  offen  sind.  Dabei  kann  noch 
spezifiziert  werden,  ob  der  Desktop  auch  zu  den  offenen  Fenstern  ziihlt  (er  kann 
meist  nicht  geschlossen  werden),  oder  ob  das  Vorhandensein  der  SchlieBbox 
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beriicksichtigt  werden  soil.  AuBerdem  kann  angegeben  werden,  ob  modale  Dia- 
logboxen  ebenfalls  zu  den  offenen  Fenstern  zahlen  sollen. 


any_open 
incl_desk 
incl_closer 
incl  modal 


: TRUE,  wenn  mindestens  ein  Fenster  dieses  Prozesses  offen  1st, 
das  auf  die  Spezifikation  zutrifft,  sonst  FALSE 
: TRUE,  wenn  der  Desktop  ebenfalls  beriicksichtigt  werden  soil, 
sonst  FALSE 

: TRUE,  wenn  nur  Fenster  berucksichtigt  werden  sollen,  die 
auch  eine  SchlieBbox  haben,  sonst  FALSE 
: TRUE,  wenn  modale  Dialogboxen  ebenfalls  als  offene  Fenster 
gezahlt  werden  sollen,  sonst  FALSE 


Von  dieserFunktion  kann  z.B,  das  Ein/Ausschalten  eines  Meniis,  welches  "Schlie- 
Ben"  heiBt,  abhangig  gemacht  werden  {siehe  auch  Modul  MENU), 


WORD  num_locked  (VOID);  f ,.,i  t ; , ; 

Zahit  die  Anzahl  der  gesperrten  Fenster.  Fenster  werden  gesperrt,  wenn  eine 
modale  Dialogbox  (auch  Alertbox)  gedffnet  wird.  Die  einzigen  nicht  gesperrten 
Fenster  sind  dann  die  Dialogbox  selbst  und  ein  eventuell  vorhandenes  Hilfe-Fen- 
ster.  AuBerdem  natiirlich  samtliche  Fenster  von  anderen  Prozessen,  die  nach  wie 
vor  bedient  werden  kbnnen. 

num_locked  : Anzahl  der  gesperrten  Fenster  < 

Die  Routine  wird  nur  vom  Modul  DIALOG  benutzt,  um  ganz  sicher  festzustellen, 
ob  eine  modale  Dialogbox  beendet  wurde. 

VOID  cycle_window  (VOID);  ivr-,  ) nu-vr 

Holt  das  unterste  Fenster  nach  oben,  wenn  es  nicht  der  Desktop  ist  oder  dutch  eine 
modale  Dialogbox  ge.sperrt  ist. 

VOID  set_cursor  (WINDOWP  window,  WORD  obj,  WORD  inx); 

Setzt  den  Cursor  einer  modalen  oder  nicht-modalen  offenen  Dialogbox  auf  ein 
bestimmtes  editierbarcs  Objekt. 

window  : Zeiger  auf  das  Fenster,  welches  eine  Dialogbox  darstellt 
obj:  Nummer  dcs  editierbaren  Objckls,  auf  das  der  Cursor  gesetzt  werden  soli 
inx:  Index  (Buclistabe)  innerhalb  des  Objekts  oder  NIL,  wenn  der  Cursor  am 
Ende  des  Textes  erscheinen  soil  ■ ^ 


VOID  drag_boxes  (WORD  num_objs,  CONST  RECT  *boxes, 

WINDOWP  inv_window,  SET  inv^objs, 

RECT  *diff,  CONST  RECT  *bound, 

WORD  x_raster,  WORD  y_raster); 

Es  kbnnen  mehrere  Rechtecke  gleichzeitig  verschoben  werden.  AuBerdem  kann 
ein  Fenster  angegeben  werden,  von  welchem  Objekte  invertiert  werden,  die 
wahrend  des  Zieh-Vorgangs  iiberstrichen  werden.  Ein  Raster  (z.B.  8 fiir  Bytera- 
ster)  gibt  an,  ob  die  Rechtecke  nur  auf  einem  imaginaren  Raster  erscheinen  sollen. 
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num_objs 

boxes 

inv_window 

inv_objs 

diff 

bound 


x_raster 

y_raster 


: Anzahl  der  Objekte,  die  verschoben  werden 
: Zeiger  aut'eine  Rechteckliste,  die  "num_objs"  Rechtecke  ent- 
halt,  welche  die  zu  verschiebenden  Rechtecke  beschreiben 
; Zeiger  auf  ein  Fenster,  von  welchem  Objekte  wiihrend  des 
Ziehens  invertiert  werden 

: Objekte,  weiche  innerhalb  dieses  Fensters  selektiert  werden 
diirfcn 

: Zeiger  auf  ein  Rechteck,  welches  die  Differenz  der  verschobe- 
nen  Rechtecke  zum  Ausgangspunkt  angibt 
: Zeiger  auf  ein  Rechteck,  in  welchem  sich  die  zu  verschieben- 
den Rechtecke  bewegen  diirfen  oder  NULL,  wenn  sich  diese 
innerhalb  des  gesamten  Desktops  bewegen  diirfen 
: X-Raster,  auf  dem  sich  die  Rechtecke  bewegen  diirfen 
: Y-Raster,  auf  dem  sich  die  Rechtecke  bewegen  diirfen 


Die  Funktion  simuliert  im  Prinzip  '’graf_dragbox”  des  AES.  Allcrdings  diirfen  hier 
mehrere  Rechtecke  angegcben  werden.  AuBerdem  konnen  noch  Objekte  eines 
Fensters  invertiert  werden.  Das  Zeichnen  der  Rechtecke  ist  eine  nichttriviale 
Aufgabe,  da  diese  auf  jedem  Hintergrund  korrekt  aussehen  sollen  (schwarze 
Linien).  Dies  gilt  vor  allem  fiir  das  Muster  des  Desktop.  Je  nach  Position  des 
Rechtecks  und  Zeichenalgoritmus  der  vier  Linien  miissen  andere  Linienmuster 
benutzt  werden.  Dieser  Algorithmus  funktioniert  zumindest  fiir  alle  Rechner,  bei 
denen  der  linke  obere  Eckpunkt  (0, 0)  beim  Desktop-Muster  nicht  gesetzt  ist.  Falls 
ein  Grafikprozessor  seine  Arbeit  verrichtet,  der  das  "Grau"  des  Desktop  invertiert 
darstellt,  bzw.  andere  Algorithmen  benutzt,  um  die  Linien  zu  zeichnen,  ist  die 
Routine  natiirlich  nicht  mehr  ganz  korrekt.  Ein  Programm,  das  z.B.  einen  unkor- 
rekten  Algorithmus  verwcndet,  ist  das  Resource-Construction-Set  von  Kuma. 
Bewegt  man  dort  Piktogramme,  so  erscheinen  Je  nach  deren  Position  abwechselnd 
schwarze  und  weiBe  Umrisse. 


Als  Ergebnis  wird  in  "diff.w"  und  "diff.h"  die  Differenz  der  Boxen  nach  dem 
Ziehvorgang  zuriickgegeben.  Dariiberhinaus  ist  in  ''diff.x"  und  "diff.y"  die  letzte 
Mausposition  gespeichert.  Beispiele  fiir  diese  Funktion  finden  sich  in  den  Modu- 
len  CLIPBRD  und  DESKTOP. 


VOID  drawjistobj  (LISTBOX  *list,  WORD  obj,  BOOLEAN  flip); 

Zeichnet  ein  Element  einer  Listbox.  Dabei  kann  noch  angegeben  werden,  ob  das 
Element  umgeschaltet  werden  soli  (von  selektiert  auf  nicht  selektiert  und  umge- 
kehrt).  Die  Programmierung  von  Listboxen  einschlieBlich  der  Listbox-Struktur 
wird  weiter  unten  erlautert. 

list  ; Zeiger  auf  eine  Listbox-Struktur 

obJ  : Objekt,  welches  gezeichnet  werden  soil 

flip  : TRUE,  wenn  das  Element  umgeschaltet  werden  soli 

BOOLEAN  listbox  (LISTBOX  *list,  UWORD  flags,  MKINFO  *mk); 

Verwaltung  einer  Listbox.  Je  nach  Angabe  eines  Flags  konnen  drei  unterschiedli- 
che  Aufgaben  angefordert  werden:  die  Initialisierung,  das  Zeichnen  und  das 
Hineinklicken. 


550 


Anhang  C.  Die  neue  Software 


list  : Zeiger  auf  eine  Listbox-Struklur 

flags  : Einer  der  folgcndcn  Wcrtc:  ■' 

LIST_1NIT  : Die  Listbox  wird  inilialisiert 

LIST_DRAW  : Die  Listbox  wird  gezeichnet  (nur  mit  L1ST_1N1T)  ' 
LIST_CLICK  : Es  wurde  in  die  Listbox  geklickt 
mk  : Zeiger  auf  eine  Maus-Keyboard-Info-Struktur,  falls  "flags”  ••  - 
LIST_CLICK  ist,  sonst  NULL 

Das  Flag  LIST_INIT  wird  benutzt,  um  die  Listbox  zu  initialisieren.  Dies  kann  auch 
mehrere  Male  geschehen  (siehe  Beispiel  in  Modul  MENU). 

Das  Flag  LIST_DRAW  wird  nur  in  Zusammenhang  mit  LIST_INIT  benutzt.  Damit 
kann  man  erreichen,  daB  diese  Listbox  beim  Initialisieren  sofort  gezeichnet  wird. 
Dies  sollte  man  tun,  wenn  sich  die  Listbox  bereits  auf  dem  Bildschirm  befindet 
und  ihre  Werte  andert  (siehe  Beispiel  in  Modul  MENU).  Wird  das  Flag  mit 
LIST_INIT  benutzt,  so  muB  es  mit  diesem  in  einer  ODER-Operation  verbunden 
werden  (L1ST_IN1T  I LIST_DRAW).  Das  Zeichnen  selbst  geschieht  ansonsten 
durch  das  Zeichnen  des  Fensters,  in  dem  sich  die  Dialogbox  befindet. 

Wird  das  Flag  LIST_CLICK  angegeben,  so  muB  in  "mk"  ein  Zeiger  auf  die 
aktuellen  Werte  der  Maus  und  des  Keyboards  iibergeben  werden.  Diese  erhalt  man 
als  Parameter,  wenn  in  ein  Fenster  geklickt  wird  (siehe  Beispiel  in  Modul  MENU). 

VOID  edit_noecho  (MKINFO  *mk,  WORD  cursor,  BYTE  *s,  WORD  maxlen); 

Die  Routine  wird  benotigt,  um  ein  PaBwort  in  einer  Dialogbox  zu  editieren. 

mk  ; Zeiger  auf  eine  MKINFO-Struktur,  aus  der  der  ASCII-Code  und  der 
Scan-Code  einer  Taste  benutzt  werden 

cursor  : Aktuelle  Position  des  Schreibcursors  

s : Zeiger  auf  die  versteckte  Zeichenkette  ' , 

maxlen  : Maximale  Anzahl  der  Zeichen  in  der  versteckten  Zeichenkette 

Die  Routine  muB  immer  aufgerufen  werden,  wenn  in  einer  Dialogbox  eine  ver- 
steckte Zeichenkette  wie  z.B.  ein  PaBwort  editiert  werden  kann.  Der  Grund  dafiir 
liegt  darin,  daB  im  editierbaren  GEM-Objekt  nur  Sternchen  erscheinen  sollen. 
Damit  diese  auch  beim  Wiederzeichnen  richtig  gehandhabt  werden  (Dialogboxen 
kdnncn  iiberlagert  werden),  miissen  im  editierbaren  Objekt  tatsachlich  nur 
Symbole  vorhanden  scin.  Die  cigentliche  Information  (z.B.  das  PaBwort)  muB  an 
einer  anderen  Stelle  abgelegt  werden  (z.B.  als  statische  Zeichenkette  im  Haupt- 
speicher). 

Jedesmal,  wenn  eine  Taste  gedriickt  wird,  wird  nun  vom  Window-Manager  ein 
in  das  GEM-Objekt  eingetragen.  Der  Programmierer  muB  nun  einen  zusatzlichen 
Aufruf  tatigen,  um  das  eigentliche  PaBwort  im  Spcicher  zu  manipulicren.  Dies 
nimmt  die  Routine  "edit_noecho"  ab.  Sie  reagiert  auch  auf  Sonderzeichen,  ESC, 
BS  Oder  DEL,  so  daB  in  der  versteckten  Zeichenkette  ganz  normal  editiert  werden 
kann. 

MuB  das  PaBwort  nun  ausgewertet  werden,  so  darf  nicht  "get_ptext"  benutzt 
werden,  da  dieser  Aufruf  nur  die  ’*’-Symbole  liefern  wurde.  Stattdessen  muB  die 
statische  Zeichenkette  benutzt  werden,  in  der  zu  jedem  Zeitpunkt  das  aktuelle 
PaBwort  steht. 
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Bei  der  Programmierung  muB  auBerdem  darauf  geachtet  werden,  daB  zu  jedem 
PaBwort  auch  eine  statische  Variable  angelegt  wind,  die  den  letzten  Index  des 
Cursors  in  diesem  PaBwort  angibt.  Der  Index  wird  zwar  in  der  WINDOW-Struktur 
festgehalten  (edit_inx),  aber  nach  dem  Driicken  beispielsweise  einer  Pfeil-rechts 
Taste  wird  dieser  Index  urn  eins  erhoht.  Dann  isl  der  Wert  des  alten  Index  nicht 
mehr  aktuell.  Dieser  muB  aber  benulzt  werden,  um  die  letzte  Aktion  in  der  Routine 
"edit_noecho"  nachzufuhren.  Im  Modul  MENU  wird  dafur  ein  Beispiel  angege- 
ben. 


BOOLEAN  init_windows  (WORD  err_nowindow,  WORD  maxreswind, 

WORD  class_help); 


Das  Modul  WINDOWS  wird  initialisiert.  Dabei  wird  eine  Konstante  fiir  die 
Fehlermeldung  "Keine  weiteren  Fenster  mehr"  und  die  Anzahl  maximal  zu  erwar- 
tender  residenter  Fenster  iibergeben.  AuBerdem  wird  die  Klasse  der  Hilfe-Fenster 
festgelegt. 


init_windows 
err  nowindow 


max_reswind 

class_help 


; TRUE,  wenn  die  Initialisierung  geklappt  hat,  sonst  FALSE 
: Index  der  Alertbox,  die  vom  Window-Manager  aufgerufen 
werden  soli,  wenn  keine  weiteren  Fenster  mehr  erzeugt  wer- 
den kbnnen  oder  NIL,  wenn  keine  Meldung  erscheinen  soil 
: Maximale  Anzahl  der  zu  erwartenden  residenten  Fenster 
: Nummer  der  Klasse  eines  Fensters,  wclchc  allc  Hilfetexte  aus- 
gibt  (wird  z.B.  in  der  Datenbank  PHOENIX  benutzt). 


Die  Initialisierung  lauft  schief,  wenn  nicht  mehrgenugend  Speicher  zur  Verftigung 
steht,  um  geniigend  Strukturen  des  Typs  WINDOW  zur  Verftigung  zu  stellen.  Die 
Anzahl  der  maximal  gleichzeitig  zur  Verfugung  stehenden  Strukturen  werden  in 
"max_reswind"  iibergeben.  Eine  Struktur  bleibt  resident  im  Speicher,  wenn  ein 
Fenster  beim  SchlieBen  nicht  gelbscht  wird.  Dies  ist  der  Fall,  wenn  das  Flag 
"WI_RESIDENT"  gesetzt  ist  und  es  keine  Mbglichkeit  gibt,  das  Fenster  komplett 
zu  Ibschen  (etwa  durch  eine  Piktogramm-Operation). 

Die  Anzahl  errechnet  sich  folgendermaBen:  Da  in  GEM  maximal  sieben  Fenster 
der  gleichen  Klasse  geoffnet  werden  kbnnen,  kbnnen  pro  Klasse,  bei  der  die 
Fenster  resident  bleiben,  auch  maximal  sieben  Strukturen  im  Speicher  stehen.  Von 
den  Fenstem,  die  nicht  resident  bleiben,  kbnnen  maximal  sieben  gleichzeitig 
geoffnet  werden.  Da  beim  SchlieBen  auch  die  Datenstruktur  freigegeben  wird, 
kann  sie  fur  das  nachste  Fenster  genutzt  werden.  Faustregel  ist  also 

7 * "Anzahl  der  residenten  Klassen"  + 7 + Anzahl  Dialogboxen 

Ausnahmen  sind  Klassen,  bei  denen  nur  maximal  ein  Fenster  existieren  kann.  Dies 
sind  z.B.  der  Desktop  oder  das  Papierkorb-  bzw.  Klemmbrettfenster.  In  unserer 
Beispielapplikation  kbnnen  maximal  21  Fenster  existieren  (maximal  sieben  davon 
offen  bzw.  acht  bei  Beriicksichtigung  des  Desktops): 

1 Desktop-Fenster 

1 Papierkorb-Fenster  . ; 

1 Klemmbrett-Fenster  . ' i 

7 Grafik-Fenster 
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Das  sind  zehn  Fenster,  die  resident  im  Speicher  gehalten  werden.  Dazu  kommen 
maximal  sieben  weitere  Fenster,  die  nicht  resident  sind  und  deswegen  nur  in 
gedffnctcm  Zustand  existieren: 

7 Meta-Datei-Fenster  Oder 
7 Bit-Image-Datci-Fenster  oder 
7 Text-Fenster  oder 

7 Fenster  mit  mathematischen  Potenzen 

Diese  letzteren  vier  Klassen  sind  nicht  resident,  so  daB  eine  beliebige  Kombination 
von  ihnen  (zusammen  maximal  sieben)  gleichzeitig  offen  sein  kann. 

Zu  dicsen  Fenstern  kommen  alle  Dialogboxen  (vier  bei  unserem  Programm),  da 
diese  ebenfalls  resident  gehalten  werden.  Dadurch  wird  erreicht,  daB  sich  die 
Dialogboxen  an  der  Stelle  offnen,  an  der  sie  zum  letztenmal  geschlossen  wurden. 
Mochte  man  dies  nicht,  kann  man  das  Flag  WI_RESIDENT  bei  Dialogboxen 
ausblenden.  In  diesem  Fall  muB  man  auch  nur  ein  Fenster  fur  obige  Formel 
berechnen. 

Die  Anzahl  der  Fenster  hatte  auch  dynamisch  ermittcll  werden  kdnnen,  indem  bei 
jedem  Offnen  eines  Fensters  dynamisch  fiir  diese  eine  Fensterstruktur  Speicher- 
platz  reserviert  werden  wurde.  Das  hatte  aber  eine  Zerstiickelung  des  Hauptspei- 
chers  zur  Folge  (besonders  bei  Accessories),  was  wir  nicht  anstreben. 

Falls  man  bei  der  Berechnung  Schwierigkeiten  hat,  sollte  man  lieber  eine  groBere 
Zahl  angeben.  50  Fenster  wird  wohl  niemand  so  schnell  erreichen.  Die  GrdBe  einer 
Fensterstruktur  ist  sizeof  (WINDOW),  was  z.  Zt.  334  Bytes  entspricht.  . 
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Im  Modul  EVENT  ist  nun  auch  die  Unterstiitzung  des  rechten  Mausknopfes 
realisiert.  Die  folgenden  globalen  Variablen  sind  erreichbar. 

GLOBAL  UWORD  events; 

Gibt  die  aktuellen  Ereignisse  an,  auf  die  gewartet  werden  soil.  Die  Variable  wird 
in  "init_event"  auf  den  Wert 

MU_KEYBD  I MU_BUTTON  I MU_M1  I MU_MESAG  I MU.TIMER 

gesetzt.  Soil  ein  Ereignis  (z.B.  MIJ_T1MER)  nicht  beriicksichtigl  werden,  so  kann 
die  Variable  nach  Aufruf  von  ”init_event"  entsprechend  modifiziert  werden.  Das 
Ereignis  MU_M1  solite  allerdings  nur  ausgeblendet  werden,  wenn  kein  Fenster 
eine  eigene  Mausform  hat. 

GLOBAL  LONG  millisecs; 

Gibt  die  aktuellen  Millisekunden  an,  auf  die  bei  einem  Zeitereignis  gewartet 
werden  soil.  Die  Variable  wird  mit  100  initialisiert. 
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GLOBAL  WORD  bclicks; 

Gibt  die  Klicks  an,  auf  die  gewartet  werden  soli.  Friiher  wurde  hier  der  Wert  2 
eingetragen  (Doppelklick).  Setzt  man  allerdings  das  niederwertigste  Bit  im  hdher- 
wertigen  Byte  (0x0102),  so  wird  auf  die  Negation  des  Mausknopfereignisses 
gewartet.  Dies  bedeutet,  wir  kdnnen  beim  Button-Status  (s.u.)  den  Wert  0 angebcn. 
Dieser  bedeutet  eigentlich,  warte  auf  Loslassen  von  Mausknopf  1 und  2 gleichzei- 
tig,  da  "bmask”  auf  3 gesetzt  wird.  Die  boolesche  Negation  bedeutet  hier  also, 
warte  auf  Driicken  von  Mausknopf  1 oder  2.  Aus  Loslassen  wird  Driicken,  aus 
"und"  wird  ”oder".  Dadurch  kann  statt  auf  das  Driicken  beider  Knopfe  zusammen 
auf  das  Driicken  jedes  der  beiden  Knopfe  gewartet  werden. 

GLOBAL  WORD  bmask; 

Maske,  die  angibt,  auf  welche  Knopfe  gewartet  werden  soli.  Die  Variable  wird  auf 
0x0003  initialisiert,  was  bedeutet,  daB  beide  Mausknopfe  benutzt  werden  sollen. 

GLOBAL  WORD  bstate; 

Maske,  die  angibt,  ob  auf  Driicken  oder  Loslassen  gewartet  werden  soil.  Durch 
die  oben  beschriebene  Negation  wird  der  Wert  auf  0x0000  initialisiert  und  nicht 
mehr  geandert.  Zunachst  wird  somit  auf  das  Driicken  der  Mausknopfe  gewartet. 
1st  dies  eingetreten,  wird  durch  Wegblenden  des  niederwertigsten  Bits  im  hoher- 
wertigen  Byte  von  bclicks  erreicht,  daB  nun  auf  das  Loslassen  gewartet  wird. 

Die  folgenden  Routinen  sind  nun  global  verfiigbar,  da  diese  zum  Teil  im  Modul 
DIALOG  aufgerufen  werden. 

VOID  hndl_e vents  (VOID); 

VOID  hndLkeybd  (MKINFO  *mk); 

VOID  hndl_button  (MKINFO  *mk); 

VOID  hndl_mesag  (WORD  *msgbuff); 

VOID  hndLtimer  (LONG  millisecs); 

Ihre  Beschreibung  kann  weiter  vorn  nachgelesen  werden. 
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Dieses  neue  Modul  wurde  konzipiert,  urn  zusammen  mit  dem  Modul  WINDOWS 
module  und  nicht-modale  Dialogboxen  sowie  Alertboxen  zu  implementieren,  die 
sich  in  Fenstern  befinden.  Dadurch  wird  eine  wesentlich  hohere  Flexibilitat 
erreicht.  Beispielsweise  kann  bei  jedem  Tastendruck  und  Mausklick  die  Applika- 
tion  entscheiden,  wie  in  der  Dialogbox  reagiert  werden  soil.  Auf  diese  Wei.se  kann 
beispielsweise  verhindert  werden,  dafi  eine  Dialogbox  mit  einer  Fehleingabe 
verlassen  wird. 

Die  Programmierung  solcher  Alertboxen  wird  weiter  unten  erklart. 

Die  folgenden  Definitionen  sind  in  der  Headerdatei  zu  finden. 

#define  CLASS  DIALOG  3 
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Die  Klasse  eines  Dialogfensters  (Dialogbox).  Dabei  ist  es  unwesentlich,  ob  es  sich 
um  eine  modale  oder  nicht-modale  Dialogbox  handelt.  Auch  Alertboxen  zahlen 
zu  dieser  Klasse. 

#define  NUM_SEP  5 

#define  SEP_OPEN  ’[’ 

#define  SEP_CLOSE  ’]’ 

#define  SEP_L1NE  ’I’ 

Die  vier  Konstanten  werden  benutzt,  um  Fehlermeldungen  zusammenzubauen. 
Das  Format  der  Fehlermeldungen  wird  bei  der  Fehlerbehandlung  beschrieben. 


typedef  BOOLEAN  (*HELPFUNC)  (BYTE  *helpmsg); 

Es  handelt  sich  um  den  Typ  einer  Hilfe-Funktion  die  aufgerufen  wird,  wenn  in 
einer  Alertbox  die  Help-Taste  gedriickt  wird.  Diese  Hilfe-Funktion  kann  mittels 
der  Funktion  "set_helpfunc”  (s.  u.)  registricrt  werden, 

BOOLEAN  init.dialog  (BYTE  **alerts,  OBJECT  *tree,  ' ' ‘ ^ 

WORD  index,  BYTE  *title); 

Initialisiert  das  Modul  DIALOG. 


init_dialog 

alerts 

tree 

index 

title 


: TRUE,  wenn  das  Initialisieren  geklappt  hat,  sonst  FALSE  ' 
: Zeiger  auf  die  Tabelle  der  Fehlermeldungen 
: Zeiger  auf  den  Objektbaum,  der  die  Alertbox  reprasentiert 
: Resource-Index  des  obigen  Objektbaumes  )( ! 

: Zeiger  auf  die  Titelzeile  aller  Fehlermeldungen 


Der  Parameter  "alerts"  ist  normalerweise  die  globale  Variable  aus  GLOBAL.H. 


Die  Alertbox  fiir  den  Parameter  "tree"  ist  in  der  Resource-Datei  SCRAP.RSC 
abgelegt.  Fiir  eigene  Anwendungen  kann  er  aus  dieser  kopiert  werden. 


Der  Parameter  "index"  ist  in  der  Datei  SCRAP.H  definiert.  Es  handelt  sich  um  den 
Bezeichner  fiir  den  Objektbaum. 


In  jeder  Alertbox,  die  ja  in  einem  echten  Fenster  dargestellt  wird,  gibt  es  eine 
Titelzeile  (Parameter  "title").  Sie  soli  den  Namen  der  Applikation  wiedergeben. 
Sie  wird  nur  einmal  festgelegt  und  andert  sich  im  Laufe  des  Programmablaufs 
nicht  mehr.  Damit  wird  gewahrleitet,  da6  Fehlermeldungen  von  verschiedenen 
Applikationen  und  Accessories  identifiziert  werden  kdnnen,  Man  darf  in  diesem 
Zusammenhang  nicht  vergessen,  daU  beim  Auftreten  eines  Fehlers  zwar  der 
aktuelle  Prozel)  "gestoppt"  wird,  bis  die  Fehlermeldung  quittiert  wird,  Jedoch 
konnen  andcre  Appikationen  Oder  Accessories  bedient  werden,  wenn  eines  ihrer 
Fenster  nach  oben  geholt  wird. 

Ein  Aufruf  von  "init_dialog"  kdnnte  z.B.  folgendermaBen  aussehen;  . 

ok  = init_dialog  (alerts,  alert,  ALERT,  " SCRAP  " ) ; 

BOOLEAN  term_dialog  (VOID); 

Das  Modul  DIALOG  wird  terminiert. 

term_dialog  : TRUE,  wenn  das  Terminieren  geklappt  hat,  sonst  FALSE. 
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VOID  set_helpfvinc  (HELPFUNC  help);  '■  . 

Setzt  die  Hilfe-Funktion  fiir  Alertboxen. 

help  : Zeiger  auf  eine  Funktion,  die  aufgerufen  wird,  wenn  in  einer  Alertbox 
der  Hilfe-Knopf  gediickt  wird  Oder  NULL,  wenn  es  keine  Hilfe-Funk- 
tion fiir  Alertboxen  gibt. 

Die  Hilfe-Funktion  wird  aufgerufen,  wenn  in  einer  Alertbox  die  Hilfe-Taste 
gedriickt  wird  und  gleichzeilig  cin  Hilfc-Bullon  dcfiniert  ist.  Der  Funktion  wird 
dann  eine  Zeichenkette  iibergeben,  durch  die  der  genaue  Kontext  ersichtlich  ist. 
Diese  Zeichenkette  kann  vom  Entwickler  selbst  bestimmt  werden  und  befindet 
sich  in  der  Datei  SCRAP.ERR.  Deren  Aufbau  wird  bei  der  Fehlerbehandlung 
weiter  unten  beschrieben. 

Der  Aufruf  von  "set_helpfunc"  kbnnte  also  folgendermaBen  aussehen: 
set_helpfunc  (appl_help> ; 

Die  Funktion  "appl_help"  muB  vorher  deklariert  weden  und  kann  dann  z.B. 
folgendermaBen  aussehen: 

LOCAL  BOOLEAN  appl_help  (helpmsg) 

BYTE  *helpmsg; 

{ 

return  (open_help  ( "SCRAP . HLP " , helpmsg)); 

} /*  appl_help  */ 

Die  Funktion  "open_help”  wiederum  sollte  sich  in  einem  Modul  HELP  befindcn. 
Ein  solchcs  Fcnstcr  hat  die  Klasse  CLASS_HELP  und  wird  damit  beim  Offnen 
nicht  gesperrt.  Somit  kann  bclicbig  zwisehen  dem  Alert-Fenster  und  dem  Hilfe- 
Fenster  umgeschaltet  werden.  Das  Hilfe-Fenster  kbnnte  aus  einer  Hilfe-Daten- 
bank,  die  z.B.  den  Namen  SCRAP.HLP  tragt,  die  iibergebene  Zeichenkette 
heraussuchen  und  den  entsprechenden  Hilfeiext  darstellen.  Auf  diese  Weise  wird 
bei  der  relationalen  Datenbank  PHOENIX  verfahren.  Die  Hilfe-Datenbank  liegt 
im  PHOENIX-Format  vor,  so  daB  der  Benutzer  diese  sogar  editieren  und  erweitern 
kann. 

WINDOWP  crl_dialog  (OBJECT  *obj,  OBJECT  *menu,  WORD  icon, 

BYTE  *title,  UWORD  flags); 

Kreiert  eine  modale  oder  nichl-modalc  Dialogbox  in  einem  Fenster. 

crt_dialog  : Zeiger  auf  das  kreierte  Fenster  oder  NULL,  wenn  es  nicht  kre- 

iert werden  konnte 

obj  : Zeiger  auf  einen  Objektbaum,  der  die  Dialogbox  reprasentiert 

menu  : Zeiger  auf  einen  Objektbaum,  der  eine  optionale  Meniizeile 

reprasentiert  oder  NULL,  wenn  keine  Meniizeile  vorhanden 
sein  soli 

icon  : Index  des  Objektbaumes  "obj”,  welcher  in  der  Resource- 

Header-Datei  abgelegt  ist.  Dieser  Wert  wird  in  "window-icon" 
abgelegt 
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title  : Fenster-Titel  der  Dialogbox 

flags  : Zusatzliche  Flags,  die  das  Verhalten  des  Fensters  steuern. 

StandardmaBig  ist  WI_RESIDENT  vorgegeben.  Dazu  kann 
kommen: 

WI_MODAL  : Eine  modale  Dialogbox  soli  erzeugt  werden 

WI_MODELESS  : Eine  nicht-modale  Dialogbox  soil  erzeugt  werden 

Beim  Kreieren  muB  man  beaehten,  daB  fiir  modale  Dialogboxen  zur  leichteren 
Identifizierung  der  SchlieB-Knopf  ausgeblendet  wird.  Zusatzlich  sollte  der  Titel 
drei  Punkte  aufweisen. 

Existiert  ein  Hilfe-Knopf  (ist  das  HELP_FLAG  gesetzt),  so  wird  dieser  Hilfe- 
Knopf  abgeschaltet,  wenn  keine  Hilfe-Funktion  existiert. 

Da  das  Fenster  resident  kreiert  wird,  wird  eine  Dialogbox  immer  an  der  Stelle 
erscheinen,  an  der  sie  zuletzt  geschlossen  wurde.  Falls  dies  nicht  gewiinscht  wird, 
kann  nach  dem  Kreieren  das  Flag  durch  den  Befehl 

window-flags  &=  ~ WI_RESIDENT;  r . :i:;; 

ausgeblendet  werden, 

BOOLEAN  open_dialog  (WORD  icon); 

Ein  Dialogfenster  (Dialogbox)  wird  gedffnet. 

open_dialog  : TRUE,  wenn  das  Fenster  geoffnet  werden  konnte,  sonst  FALSE 
icon  : Index  des  Objektbaumes  der  Dialogbox,  welcher  in  der 

Resource-Header-Datei  abgelegt  ist.  Dieser  Wert  wurde  bei 
crt_dialog  in  "window-icon"  abgelegt. 

Kann  die  Dialogbox  nicht  gedffnet  werden,  so  wird  keine  Fehlermeldung  ausge- 
geben,  da  dieses  Modul  applikationsunabhangig  programmiert  ist.  Die  Fehlermel- 
dung muB  vom  Aufrufer  ausgegeben  werden. 

WORD  hndLalert  (WORD  alertjd);  '' 

Behandelt  eine  Fehlermeldung. 

hndl_alert  : Wert  des  Knopfcs,  der  zur  Beendigung  des  Fehlerdialoges  ge- 
fiihrt  hat,  wobei  gilt:  1 = erster  Knopf,  2 = zweiter  Knopf  usw. 
alertjd  : Nummer  der  Fehlermeldung  aus  ERRORS, H 

Die  Funktion  ruft  lediglich  "open_alert"  mit  der  entsprechenden  Zeichenkette  aus 
SCRAP.ERR  auf. 

WORD  open_alert  (BYTE  *alertmsg); 

Offnet  eine  Alertbox  und  behandelt  deren  Darstellung  und  Interaktion. 

open_alert  : Wert  des  Knopfes,  der  zur  Beendigung  des  Fehlerdialoges  ge- 
fiihrt  hat,  wobei  gilt:  1 = erster  Knopf,  2 = zweiter  Knopf  usw. 
alertmsg  : Zeiger  auf  eine  Zeichenkette  (z.B.  aus  der  Datei  SCRAP.ERR), 

welche  das  folgende  Format  aufweisen  muB: 

[Piktogramm][Fehlertext][Kn6pfe][Belegung][Hilfetext]  - 
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Piktogramm  kann  die  Werte  0 bis  3 annnehmen,  wobei  gilt:  kdVs-  'jii, 

0:  Info-Piktogramm 

I : Ausrufezeichen-Piktogramm  : ; ;•-  : n 

2:  Fragezeichen-Piktogramm  ■ 

3:  STOP-Piktogramm 

Der  Fehlertext  kann  in  einzelne  Zeilen  aufgespalten  warden.  Dabei  werden  die 
Zeilen  mit  dem  Zeilentrenner  (SEP_LINE  = T)  getrennt.  Es  kbnnen  maximal  5 
Zeilen  (NUM_SEP)  mit  jeweils  maximal  40  Zeichen  definiert  werden.  1st  eine 
Zeile  zu  lang,  so  wird  sie  abgeschnitten.  Auf  keinen  Fall  ragt  sie  falschlicherweise 
in  die  nachste  Zeile,  wie  dies  bei  den  GEM-Alertboxen  der  Fall  ist. 

Der  Text  der  Kndpfe  wird  wie  der  Fehlertext  beschrieben.  Maximal  konnen  5 
Knopfe  zu  jeweils  maximal  12  Buchstaben  Platz  finden.  Nicht  benutzte  Knopfe 
werden  versteckt.  Die  restlichen  Knopfe  werden  zentriert  dargestellt. 

Die  Default-Belegung  der  Knopfe  wird  im  nachsten  Feld  angegeben.  Sie  besteht 
immer  aus  vier  Zahlen,  die  durch  einen  Separator  (T)  getrennt  werden.  Die  vier 
Zahlen  bedeuten: 


Position  1: 

Position  2: 
Position  3: 
Position  4: 


1 = Klingelzeichen  mit  der  Fehlermeldung 

2 = Kein  Klingelzeichen  mit  der  Fehlermeldung 
Nummer  des  Default-Knopfes  oder  0,  wenn  nicht  vorhanden 
Nummer  des  Abbruch-Knopfes  oder  0,  wenn  nicht  vorhanden 
Nummer  des  Hilfe-Knopfes  oder  0,  wenn  nicht  vorhanden 


Im  folgenden  wird  ein  Beispiel  fiir  eine  Alertbox  gegeben.  In  einer  Datei  wie 
SCRAP.ERR  stehen  alle  Alertmeld ungen  auf  jeweils  einer  ganzen  Zeile.  Im 
folgenden  Beispiel  mu6  wegen  der  Lange  die  Zeile  umbrochen  werden. 


[2] 

[Drucker  wird  von  anderem  ProzessI 
belegt . Soil  der  Prozess  gespoolt | 

Oder  auf  die  Freigabe  des  Druckers | 
gewartet  werden?] 

[Spoolen I Warten I Abbruch I Hilfe] 

[0111314] 

[Warnung:  Drucker  belegt] 

Wir  haben  also  eine  Alertbox  mit  Piktogramm  2 (Fragezeichen).  Danach  folgt  der 
Text  der  Alertbox  (vier  Zeilen).  Es  gibt  vier  Kndpfe.  Es  soil  kein  Klingelzeichen 
ertdnen  (0),  der  Default-Knopf  ist  1 (Spoolen),  der  Abbruch-Knopf  ist  3 (Abbruch) 
und  der  Hilfe-Knopf  ist  4 (Hilfe).  Wird  dieser  betatigt,  so  wird  die  Hilfe-Funktion 
aufgerufen,  wobei  an  sie  die  Zeichenkette  "Warnung:  Drucker  belegt"  ubergeben 
wird.  Die  Hilfe-Funktion  muR  vorher  uber  "set_hclpfunc"  registriert  worden  sein. 
1st  dies  nicht  der  Fall,  so  wird  der  Hilfe-Knopf  grau  dargestellt. 

Erscheint  eine  solche  Alertbox  auf  dem  Bildschirm,  so  kann  sie  nach  Belieben 
verschoben  werden,  da  es  sich  um  ein  Fenster  handelt.  AuBerdem  kann  eine 
Hilfe-Funktion  aufgerufen  werden,  welche  den  eigentlichen  ProgrammfluB  nicht 
stort.  Mochte  man  die  Alertbox  nur  mit  der  Tastatur  bedienen,  so  kann  man  die 
Return-Taste,  die  Undo-Taste  und  die  Help-Taste  verwenden.  AuBerdem  besteht 
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die  Moglichkeit,  durch  die  Tab-Taste  bzw.  dutch  Shift-Tab  den  Default-Knopf  zu 
verandern.  Dieser  wandert  dann  immer  urn  eine  Position  weiter. 

Alertboxen  sind  nicht  resident,  so  daB  eine  neue  Alertbox  immer  in  der  Mitte  des 
Schirmes  erscheint. 

Tritt  der  Extremfall  auf,  daB  keine  Fenster  mehr  zur  Verfiigung  stehen  (7  Fenster 
bereits  gebffnet),  kann  eine  solche  Alertbox  nicht  in  einem  Fenster  dargestellt 
werden.  Da  nun  auch  die  Fehlermeldung  "Das  Objekt  kann  nicht  gebffnet  wer- 
den!"  nicht  crscheinen  darf  (Rekursion),  wird  die  Alertbox  als  normalc  GEM-Dia- 
logbox  dargestellt.  In  diesem  Fall  wird  der  Hilfe-Knopf  abgeschaltet  und  die 
Tabulator-Steuerung  sowie  die  Undo-Taste  funktionieren  nicht  mehr. 

GLOBAL  BOOLEAN  set_alert  {BOOLEAN  as.dialog); 

Setzt  den  Alertmodus.  Damit  kann  bestimmt  werden,  ob  Alertboxen  im  Fenster 
Oder  als  GEM-Dialogbox  erschcinen  sollen. 

set_alert  : Liefert  den  alien  Alertmodus,  also  TRUE,  wenn  Alertboxen 

als  Dialogboxen  behandelt  werden  sollen,  sonst  FALSE 
as_dialog  ; TRUE,  wenn  Alertboxen  als  GEM-Dialogboxen  behandelt 

werden  sollen,  sonst  FALSE 

Das  Setzen  des  Alertmodus  ist  nur  nbtig,  wenn  beim  Neuzeichnen  eines  Fensters 
ein  Fehler  auftreten  kann.  In  diesem  Fall  wurde  durch  eine  normale  Fehlerbehand- 
lung  erreicht  werden,  daB  beim  SchlieBen  der  Alertbox  eine  erneute  REDRAW- 
Message  des  "fehlerhaften"  Fensters  gesendet  wiirde.  Diese  wiirde  durch  das 
Neuzeichnen  eventuell  wieder  eine  Alertbox  anstoBen  usw.  Durch  das  Setzen  des 
Alertmodus  wird  erreicht,  daB  keine  neue  REDRAW-Mcssage  gesendet  wird,  da 
der  Bildschirmhintergrund  der  nicht-bewegbaren  Dialogbox  gerettet  wird. 

Ein  Setzen  des  Alertmodus  kann  ebenfalls  sinnvoll  sein,  wenn  man  Statusmeldun- 
gen  in  einer  gewbhniichen  Dialogbox  ausgibt  und  wahrend  dieser  Meldung  ein 
Fehler  auftreten  kann.  Da  diese  gewbhnliche  Dialogbox  keine  REDRAW-Message 
erhalt,  wiirde  der  Bildschirmhintergrund  nicht  richtig  restauriert  werden. 

Beim  Setzen  des  Alertmodus  geht  man  so  vor,  daB  man  sich  in  einer  Variablen  den 
alten  Wert  merkt,  und  diesen  wieder  hineinschreibt. 

Beispiel: 

BOOLEAN  old  mode; 

old_mode  = set_alert  (TRUE); 

/*  kritischer  Bereich...  */  . , 

set_alert  (old_mode) ; . ■ 

} 

VOID  hndl_modal  (BOOLEAN  use_timer); 

Behandelt  modale  Dialogboxen  und  Alertboxen.  Dabei  kann  angegeben  werden, 
ob  der  Timer  ebenfalls  beriicksichtigt  werden  soil. 
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use_timer  : TRUE,  wenn  der  GEM-Tiitier  beriicksichtigt  werden  soli, 
sonst  FALSE 

Die  Routine  hat  eine  eigene  "evnt_multi"  Schleife,  die  terminiert,  wenn  die 
Situation,  die  zum  modalen  Zustand  gefuhrt  hat,  beendet  ist,  Eine  solche  Situation 
ist  z.B.  das  Offnen  einer  modalen  Dialogbox  oder  einer  Alertbox.  Wird  diese 
geschlossen,  so  terminiert  die  Schleife  und  das  Programm  wird  an  der  Aufrufstelle 
fortgesetzt.  In  der  Zwischenzeit  kdnnen  aber  belicbige  Nachrichten  eintreffen,  wie 
z.B.  das  Neuzeichnen  eines  Fensters.  Diese  werden  ebenfalls  beriicksichtigt. 

Nicht  beriicksichtigt  werden  Menu-Ereignisse  (die  Meniizeile  ist  beim  modalen 
Zustand  abgeschaitet)  und  eventuell  Timer-Ereignisse,  da  wahrend  dieser  Ereig- 
nisse  Fehlermeldungen  auftreten  kdnnen.  Insbesondere  kann  dieses  bei  Abarbei- 
tung  eines  Fehlers  sein.  Es  darf  aber  nur  eine  Alertbox  auf  dem  Bildschirm  sein, 
da  nur  eine  Resource  dafiir  existiert.  Aus  diesem  Grund  wird  eine  Alertboxbehand- 
lung  ohne  Timer  durchgefiihrt. 

Ruft  man  selbst  "hndLmodal"  auf,  nachdem  man  ein  Fenster  gedffnet  hat,  so  ist 
dieses  Fenster  modal  (es  sperrt  alle  anderen  Fenster  bis  auf  das  Hilfe-Fenster)  und 
erst  nach  SchlieBen  desselben  wird  im  Programm  weiterverfahren.  In  diesem  Fall 
kann  man  "hndl_modal"  mit  dem  Parameter  TRUE  aufrufen.  In  der  Praxis  wird 
man  aber  auf  einen  Aufruf  von  "hndLmodar  ganz  verzichten  kdnnen,  da  dies 
intern  schon  fiir  modale  Dialogboxen  und  Alertboxen  erledigt  wird. 

Ist  ubrigens  eine  modale  Dialogbox  gedffnet,  so  diirfen  daraus  weitere  modale 
Dialogboxen  oder  Alertboxen  gedffnet  werden.  Der  modale  Zustand  wird  durch 
einen  jeweils  neuen  Aufruf  von  "hndl_modal"  geslapelt,  so  daB  erst  nach  dem 
SchlieBen  der  letzten  modalen  Dialogbox  das  Programm  an  der  Ursprungsstelle 
weiterlauft.  Bei  jedem  Aufruf  von  ' hndLmodal"  wird  die  aktuelle  Mausform 
gerettet  und  wieder  restauriert. 
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In  diesem  Modul  wurden  kleinere  Anderungen  vorgenommen,  die  aber  wichtig 
sind. 

Die  Konstante  CLASS_HELP  wird  als  die  Ziffer  2 definiert.  Normalerweise  wird 
die  Klassenkonstante  in  der  Headerdatei  des  entsprechenden  Moduls  definiert 
(z.B.  HELP.H).  Hier  haben  wir  aber  aus  Platzgrunden  auf  eine  Implementierung 
eines  eigenen  Hilfe-Moduls  verzichtet. 

Die  Konstante  ALERT_NAME  wird  als  Zeichenkette  "SCRAPERR"  definiert.  Sie 
gibt  an,  wo  sich  die  Datei  mit  den  Fehlermeldungen  befinden  soli.  Sie  wird  dann 
mittels  "read_alerts",  einer  lokalen  Funktion,  eingelesen. 

Der  Aufruf  "init_windows"  wurde  geandert: 

ok  &=  init_windows  (NOKIN20W,  MAX_RESWIND,  CLASS_HELP ) ; 

Als  letzter  Parameter  soil  hier  die  Klasse  des  Hilfe-Fensters  angegeben  werden. 
Ein  echtes  Hilfe-Fenster  wurde  hier  aber  nicht  implementiert.  Es  handelt  sich  um 
ein  gewdhnliches  Fenster,  welches  Hilfetexte  ausgeben  kann.  Im  Modul  WIN- 
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DOWS  wird  ein  Fenster  dieser  Klasse  aber  nicht  gesperrt,  wenn  z.B.  eine  modale 
Dialogbox  oder  eine  Alertbox  offen  ist,  so  daB  man  eine  kontextsensitive  Hilfe  zu 
jedem  Zeitpunkt  implementieren  kann.  Ein  Beispie!  fur  eine  solche  Hilfe  zeigtdas 
relationale  Datenbanksystem  PHOENIX.  Dort  kann  zu  jedem  Zeitpunkt  die  Help- 
Taste  bzw.  FI  gedriickt  werden  und  es  erscheint  ein  Hilfe-Fenster,  das  beliebig 
manipuliert  werden  kann  - auch  wenn  eine  modale  Dialogbox  Oder  eine  Alertbox 
offen  ist. 

Der  Aufruf  "init_dialog"  wurde  hinzugefiigt: 

ok  &=  init._diaioq  (alerts,  alert,  ALERT, 

(BYTE  *)freetext  [FDESKNAMj  . ob_spec)  ; V 

Seine  Parameter  wurden  bereits  im  Modul  DIALOG  erklart.  • - 


ERRORS.H 

Die  Datei  ERRORS. H nimmt  die  Konstanten  aller  Fehlermeldungen  auf,  die  in 
dem  Programm  vorkommen  konnen.  Die  Fehlermeldungen  miissen  bei  0 beginnen 
und  fortlaufend  numeriert  sein.  Wer  mochte,  kann  dies  auch  mit  einem  enum-Feld 
erreichen,  so  sein  Compiler  dessen  machtig  ist.  * ; . . on-  . ;r-  * j.. 


Modul  RESOURCE 

Die  benutzerdefinierten  Objekte  (extended  object  types,  ob_type  = G_USERDEF) 
haben  sich  geandert.  Folgende  3 Typen  stehen  zur  Verfiigung: 

#define  DHEADER  0x0020 
#define  DHEIGHT  0x0040 
#define  DCRBUTTON  0x0080 

DHEADER  wird  benutzt,  um  Uberschriften  ftir  Rahmen  zu  erzeugen.  Der  Text 
wird  um  die  halbe  Hohe  des  Systemzeichensatzes  nach  oben  verschoben,  was  in 
jeder  Aufldsung  funktioniert. 

DHEIGHT  wird  benutzt,  um  ein  Objekt  um  die  halbe  Hohe  des  Systemzeichensat- 
zes kleiner  zu  machen.  Die  Kndpfe  der  Dialogboxen  werden  mit  diesem  Typ 
versehen,  damit  sie  nicht  zu  groB  erscheinen.  Sie  sind  dann  1 .5  Zeichen  hoch.  Auch 
die  Dialogboxen  selbst  (ROOT)  werden  mit  diesem  Typ  versehen,  wenn  am 
unteren  Rand  Knopfe  erscheinen.  Da  die  Knopfe  ja  etwas  kleiner  sind,  sollte  die 
Dialogbox  selbst  ebenfalls  kleiner  sein,  um  den  Abstand  zum  unteren  Rand  nicht 
zu  groB  werden  zu  lassen. 

DCRBUTTON  wird  benutzt,  wenn  Objekte  Checkboxes  oder  Radiobuttons  sein 
sollen.  Der  Wert  ob_flags  eines  Objekts  muB  den  Wert  RBUTTON  beinhalten  (wie 
das  bei  "normalen"  Radiobuttons  ja  auch  gemacht  wird),  wenn  ein  runder  Radio- 
button  gezeichnet  werden  soil.  Ist  RBUTTON  nicht  gesetzt,  so  handelt  es  sich  um 
eine  Checkbox.  Checkboxen  werden  im  Dialogfenster  "Einstellungen"  benutzt. 
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Beispiele; 

- Ein  Knopf  soli  um  eine  halbe  Zeichensatzhbhe  kleiner  gemacht  und  um 
denselben  Betrag  nach  oben  verschoben  werden.  Das  obere  Byte  von  ob_type 
muS  den  Wert  DHEADER  + DHEIGHT  = 0x60  = 96  haben. 

- Ein  Radiobutton  mu6  in  ob_flags  den  Wert  RBUTTON  besitzen  und  im  oberen 
Byte  von  ob_type  den  Wert  DCRBUTTON  = 0x80  = 128. 

- Soil  der  Radiobutton  von  b)  noch  um  eine  halbe  Zeile  nach  oben  verschoben 
werden,  so  ist  in  ob_type  der  Wert  DHEADER  + DCRBUTTON  = OxAO  = 160 
zu  setzen. 

Das  obere  Byte  in  ob_type  kann  in  alien  neuen  Resource  Construction  Sets  leicht 
gesetzt  werden.  Es  heiBt  dort  "Extended  type"  Oder  "Extended  Object  Type". 

Neu  ist  auch  das  Setzen  von  Abbruch/Hilfe-Attributen  fiir  die  Knopfe  von  Dialog- 
boxen.  AuBerdem  kann  das  Attribut  NO_ECHO  gesetzt  werden.  Im  Beispiel 
werden  die  Knopfe  der  Settings-Dialogbox  initialisiert. 

do_flags  (settings,  SPASSWD,  NOECHO.FLAG); 

do_flags  (settings,  SCANCEL,  UNDO_FLAG); 

do_flags  (settings,  SHEEP,  HELP_FLAG); 

So  kann  das  System  bei  Driicken  der  UNDO-  bzw.  HELP-Taste  den  richtigen 
Knopf  aus  einer  Dialogbox  auswahlen.  Zusatzlich  kann  der  Window-Manager  das 
Echo  des  Passwortes  unterdriicken. 
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Die  Moglichkeiten  der  Dialoggestaltung  wurden  erheblich  erweitert.  Es  ist  Jetzt 
moglich,  Dialoghoxen  in  Fenstern  darzustellen.  Dadurch  kdnnen  Dialoge  frei  auf 
dem  Bildschirm  bewegt  werden. 

Des  weiteren  konnen  sogenannte  nicht-modale  Dialoge  erstellt  werden.  Das  sind 
Dialogfenster,  die  es  erlauben  weiterzuarbeiten,  auch  wenn  der  Dialog  noch  nicht 
beendet  ist.  Durch  das  einfache  Setzen  eines  Flags  (Wl_MODELESS  bzw. 
Wl_MODAL)  kann  der  Modus  bestimmt  werden. 

Die  beiden  Dialogfenster  "Einstellungen"  sowie  "Schriftauswahl"  im  Modul  ME- 
NU sind  nicht-modale  Dialoge,  die  "About"-Box  ist  ein  modaler  Dialog. 

Dadurch,  daB  man  in  beiden  Dialogfensterarten  (modal  und  modeless)  bei  jedem 
Tastendruck  und  bei  jedem  Mausklick  vom  Modul  WINDOWS  aufgerufen  wird, 
besteht  die  Moglichkeit,  Dialogfenster  "kontextsensitiv"  zu  beeinflussen.  Vorbei 
sind  die  Zeiten,  in  denen  man  das  Flag  "TOUCHEXIT"  setzen  muBte,  um  den 
Dialog  kurzzeitig  zu  verlassen,  wenn  man  z.B.  den  OK-Button  "grau"  machen 
wollte,  well  eine  Bedingung  nicht  mehr  erfiillt  ist.  Das  geht  jetzt  alles  viel 
eieganter. 

Da  Dialogfenster  wie  "normale"  Fenster  behandelt  werden,  kann  man  in  die 
Fensterstruktur  (struct  WINDOW)  alle  zur  Verfiigung  stehenden  Funktionen  zur 
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Laufzeit  einhangen,  wenn  diese  benotigt  werden.  Meistens  werden  es  die  folgen- 
den  Funktionen  sein: 


- wi_click 

- wi_key 

- wi_showhelp 

- wi_open 

- wi_close 

- wi_draw  (seltener) 


Als  Beispiel  dient  hier  das  Dialogfenster  fiir  die  Einstellungen.  Zunachst  folgt  das 
Listing  und  dann  die  Beschreibung  der  einzelnen  Funktionen. 

LOCAL  VOID  get_settings  () 

{ 

STRING  s; 


get_ptext  (settings,  SBLINK,  s)  ; 
sscanf  (s,  "%cl",  Sblinkrate)  ; 

ring_bell  = get_checkbox  (settings,  SBEEP); 
grow_shrink  = get_checkbox  (settings,  SGROW) ; 

} /*  get_settings  */ 

/^^★★★★★★★★★*'lk****lk*'**********lk*'*Tk*****?lt****>klkTk****lk'**Tk'*ik*********l^Jir*y 

LOCAL  VOID  set_settings  () 


STRING  s; 

sprintf  (s,  "%d",  blinkrate) ; 
set_ptext  (settings,  SBLINK,  s)  ; 

set_checkbox  (settings,  SBEEP,  ring_bell); 
set_checkbox  (settings,  SGROW,  grow_shrink) ; 

undo_state  (settings,  SOK,  DISABLED) ; 

) /*  set_settings  */ 

/**★*★★**★*★★******★★*★★***★★*★★★******★*★*★★★★★**■**★★**************/ 

LOCAL  VOID  click_settings  (window,  mk) 

WINDOWP  window; 

MKINFO  *mk; 

{ 

switch  (window->exit_ob j ) 

{ 

case  SOK  : get_settings  ( ) ; 

break; 

case  SCANCEL  : set_settings  (); 
break; 

case  SHELP  : help_settings  (NULL,  NIL) ; 

undo_state  (window->ob ject,  window->exit_ob j , 
SELECTED) ; 

draw_object  (window,  window->exit_ob j) ; 
break; 

} /*  switch  */ 

} /*  click_settings  */ 
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LOCAL  BOOLEAN  key_settings  (window,  mk) 

WINDOW?  window; 

MKINFO  *mk; 

( 

BYTE  *p; 

switch  (window->edit_ob j ) 

( 

case  SBLINK  : 

p = ( (TEDINFO  *)  settings  [SBLINK] . ob_spec) ->te_ptext ; 
if  {(*p  ==  EOS)  ==  ! is_state  (settings,  SOK,  DISABLED)) 
( 

flip_state  (settings,  SOK,  DISABLED) ; 
draw_object  (window,  SOK) ; 

) /*  if  */ 
break; 

} /*  switch  */ 

return  (FALSE); 

) /*  key_settings  */ 

LOCAL  BOOLEAN  help_settings  (window,  icon) 

WINDOW?  window; 

WORD  icon; 

{ 

BOOLEAN  ok; 

WINDOW?  helpwin; 

helpwin  = search_window  (CLASS_DIALOG,  SRCH_ANY,  SETHEL?) ; 

if  (helpwin  =«  NULL) 

{ 

sethelp->ob_x  = desk.x  + desk.w  - sethelp->ob_width; 
sethelp->ob_y  = desk.y  + desk.h  - sethelp->ob_height; 

helpwin  = crt_dialog  (sethelp,  NULL,  SETHEL?, 

(BYTE  *)freetext  [FHEL?SET] . ob_spec,  WI_MODELESS) ; 

) /*  if  */ 

ok  = helpwin  !=  NULL; 

if  (ok) 

{ 

if  (helpwin->opened  ==  0) 

( 

helpwin->work . X = helpwin->scroll -x  = 

desk.x  + desk.w  - sethelp->ob_width; 
helpwin->work .y  = helpwin->scroll .y  = 

desk.y  + desk.h  - sethelp->ob_height; 

} /*  if  ♦/ 

if  (!  open_dialog  (SETHEL?))  hndl_alert  (ERR_NOO?EN) ; 

} /*  if  */ 

return  (ok) ; 

} /*  help_settings  */ 
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! ★*★**★★***  **************************************************************** ! 
LOCAL  VOID  msettings  () 

( 

WINDOWP  window; 

WORD  ret; 

window  = search_window  (CLASS _DTALOG,  BRCH_ANY,  SETTINGS); 
if  (window  ==  NULL) 

{ ' 
form_center  (settings,  &ret,  iret,  &ret,  Sret); 
window  = crt_dialog  (settings,  NULL,  SETTINGS, 

(BYTE  *)freetext  (FSETTING ) . ob_spec, 
WI_MODELESS) ; 

if  (window  !=  NULL) 

{ ' . U :-- 

window->clic)c  = clic)c_settings; 

window->key  - )ieY_settings; 

window->showhelp  = help_settings;  ■ ; • 

tindo_state  (window->object,  SHELF,  DISABLED); 

) /*  if  */ 

} /*  if  */  ; 

if  (window  !=  NULL) 

{ 

if  (window->opened  --  0 ) 

( 

window->edit_ob  j = find_flags  (settings,  ROOT,  EDITABLE)  ,- 
window->edit_inx  = NIL; 

set_settings  (); 

} /*  if  * / ^ 

if  (!  open_dialog  (SETTINGS))  hndl  alert  (ERR_NOOPEN) ; 

1 /*  if  */ 

) /*  msettings  */ 

y'*****-*********'*ft*<tS^******#**************'**'*'****<r**<r***ilr^A::Jjikiij***^ilf'^f'(l(il(^ 


LOCAL  VOID  msettings  0 

Zunachst  wird  nachgesehen  (search_window),  ob  das  Dialogfenster  schon  exi- 
stiert.  Dies  ist  der  Fall,  wenn  es  zuvor  schon  geoffnet  wurde,  Existiert  noch  keines, 
so  wird  es  zentriert  und  dann  ein  neues  Fenster  erzeugt. 

Der  erste  Parameter  ist  immer  der  Objektbaum,  der  ja  im  RCS  erstellt  wurde. 

Der  zweite  Parameter  enthalt  den  Objektbaum  einer  Meniileiste.  Dialogfenster 
konnen  also  auch  mit  Meniileisten  ausgestattet  werden  (die  Funktionen  updt_me- 
nu  und  hndl_menu  miissen  dann  eingehangt  werden,  wie  dies  beim  Modul 
CLIPBRD  gemacht  wurde), 

Der  dritte  Parameter  ist  die  Konstante,  die  im  RCS  fiir  den  Objektbaum  angegeben 
wurde  (SETTINGS). 
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Der  vierte  Parameter  ist  die  Uberschrift  fiir  das  Dialogfenster.  Sie  erscheint  in  der 
Titelzeile  des  Fensters. 

Der  letzte  Parameter  ist  das  Flag,  das  angibt,  ob  der  Dialog  "modal''  oder  "nicht- 
modal"  (modeless)  ausgefuhrt  werden  soli.  In  obigem  Beispiel  WI_MODELESS. 

Konnte  das  Dialogfenster  erzeugt  werden,  so  werden  die  Funktionen  click,  key 
und  help  eingehangt.  Dadurch  werden  bei  einem  Mausklick  in  das  Dialogfenster 
die  Funktion  click_settings,  bei  einer  Taste  die  Funktion  key__settings  und  bei 
Driicken  der  Hilfe-  bzw.  FI -Taste  die  Funktion  help_settings  aufgerufen. 

Falls  es  wie  hier  eine  Hilfe  gibt,  wird  der  Hilfe-Knopf  selektierbar.  (undo_sta- 
te...DISABLED). 

Ist  das  Fenster  gerade  geschlossen  (opened  ==  0),  so  werden  noch  3 Initialisierun- 
gen  vorgenommen.  Das  edit_obj  wird  so  eingestellt,  dafi  es  auf  das  erste  Objekt 
zeigt,  das  editierbar  (EDITABLE)  ist.  Der  edit_inx  wir  auf  NIL  gesetzt,  was 
bedeutet,  daB  der  Cursor  fiir  das  erste  Edit-Objekt  - wie  in  Dialogboxen  iiblich  - 
ans  Ende  plaziert  wird.  Hier  konnte  man  den  (Cursor  auch  anders  einstellen. 

SchlieBlich  wird  die  Funktion  set_settings  aufgerufen,  die  die  Werte  aus  den 
globalen  Variablen  (blinkrate,  ring_bell  und  grow_shrink)  in  die  GEM-Objekte 
iibertragt.  Die  inverse  Funktion  dazu  lautet  get_settings.  Sie  holt  die  Werte  aus  der 
Dialogbox  und  speichert  sie  in  den  entsprechenden  globalen  Variablen  ab. 

Diese  beiden  Funktionen  bekommen  noch  eine  wichtige  Bedeutung  in  der  Funk- 
tion key_settings  (besonders  bei  nicht-modalen  Dialogfenstern). 

Sind  die  Initialisierungen  vorgenommen,  wird  das  Dialogfenster  gedffnet 
(open_dialog).  Bei  einem  Fehler  wird  eine  entsprechende  Fehlermeldung  iiber 
hndl_alert  aufgerufen. 

Achtung!  Ist  der  Dialog  nicht-modal,  so  kehrt  die  Funktion  open_dialog  sofort 
zuriick,  womit  auch  die  Funktion  msettings  beendet  ist.  Bei  "modalen"  Dialogen 
wird  von  open_dialog  erst  zuriickgekehrt,  wenn  der  Dialog  beendet  ist  (z.B.  der 
OK-Knopf  wurde  gedriickt).  In  diesem  Fall  konnte  man  noch  einige  Aktionen 
unternehmen,  je  nachdem  wie  der  Dialog  beendet  wurde.  Z.B.  konnte  msettings 
einen  Funktionswert  zuriickliefern. 

LOCAL  VOID  get_settings  (VOID) 

Wie  oben  erwahnt  holt  diese  Funktion  alle  Werte  aus  einem  Objektbaum  und  legt 
sie  an  geeigneter  Stelle  ab. 

LOCAL  VOID  set_settings  (VOID) 

Diese  Funktion  legt  die  benotigten  Werte  im  Objektbaum  ab.  Dafiir  eignen  sich 
besonders  die  Funktionen  set_ptext,  set_checkbox  (fiir  Checkboxen)  sowie 
set_rbutton  (fiir  Radiobuttons).  Hier  wird  auch  der  OK-Knopf  zuriickgesetzt,  falls 
dieser  vorher  "grau"  (DISABLED)  war.  Das  kann  dann  der  Fall  sein,  wenn  der 
Dialog  vorher  in  einem  ungiiltigen  Zustand  mit  dem  ABBRUCH-Knopf  verlassen 
wurde.  Der  OK-Knopf  war  in  diesem  Fall  grau.  Dies  tritt  ein,  wenn  der  Wert  in 
der  Blinkrate  geioscht  wird. 

,'.i ' O’c 
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LOCAL  VOID  click_settings  (WINDOWP  window,  MKINFO  *mk) 

Diese  Funktion  wird  vom  Modul  WINDOWS  aufgerufen,  wenn  in  die  Dialogbox 
geklickt  wurde.  Das  Dialogfenster  (window),  sowie  die  Maus/Keyboard-Informa- 
lionen  (mk)  warden  iibergeben.  Das  exit-Objekt  des  Fensters  ist  das  Objekt,  auf 
das  man  geklickt  hat.  In  cinem  switch-Statcmcnl  kdnnen  die  Fiil]e  bchandelt 
warden,  die  wichtig  erscheinen. 

Wurde  der  OK-Knopf  (SOK)  gcdriickt,  so  holt  man  die  Werte  aus  der  Dialogbox 
(get_settings).  1st  der  Dialog  "modal"  isterdanach  beendet.  Ist  er  nicht-modal  und 
wurde  mit  der  rechten  Maustaste  OK  gedriickt,  warden  die  Werte  geholt  und  fiir 
das  Gesamt-Programm  iiber  die  globalen  Variablen  zur  Verfiigung  gestellt,  aber 
das  Fenster  bleibt  gcol'fnct. 

Entsprechendes  gilt  fur  den  ABBRUCH-Knopf  (SCANCEL).  Die  Funktion 
set_settings  sorgt  bei  nicht-modalen  Dialogen,  bei  denen  mit  der  rechten  Mausta- 
ste auf  Abbruch  gedriickt  wurde  dafiir,  daB  die  alten  Werte  wieder  erscheinen. 
Teste  Sie  es  aus,  indem  Sie  z.B.  die  Blinkrate  verstellen  (hier  kdnnen  Sie  auch  die 
+!~  Tasten  verwenden)  und  mit  der  rechten  Maustaste  auf  "Abbruch"  klicken. 

Wird  der  HILFE-Knopf  gedriickt,  so  wird  help_settings  aufgerufen.  AnschlieBend 
wird  der  HILFE-Knopf,  der  ja  selektiert  war,  wieder  zuriickgesetzt  (undo_state) 
und  der  Knopf  iiber  draw_object  neu  gezeichnet.  .« 

LOCAL  BOOLEAN  key.settings  (WINDOWP  window,  MKINFO  *mk) 

Diese  Funktion  wird  vom  Modul  WINDOWS  aufgerufen,  wenn  cine  Taste  ge- 
driickt wurde.  Sie  muB  hier  immer  FALSE  liefern.  Das  edit_obj  in  der  WINDOW- 
Struktur  enthalt  die  Objektnummer  an  die  das  Zeichcn  gegangcn  ist.  In  unscrem 
Fall  gibt  es  nur  ein  Editobjekt  (SBLINK).  Wir  holen  uns  den  Zeigcr  auf  den  Text 
des  Objekts.  Ist  der  Text  leer,  so  soil  der  OK-Knopf  grau  werden,  wenn  er  es  nicht 
schon  ist.  Ist  der  Text  nicht  leer,  so  soil  der  OK-Knopf  schwarz  dargestellt  werden, 
urn  zu  signalisieren,  daB  der  Dialogzustand  giiltig  ist. 

Diese  Kontextsensitivitat  hilft  dem  Benutzer  ungemein.  Falsche  Eingaben  kdnnen 
schon  im  Vorfeld  verhindert  werden.  So  werden  Fehlermeldungen  nahezu  iiber- 
fliissig.  Die  Meldung  "Undefinierte  Blinkrate",  die  erscheinen  miiBtc,  wenn  OK 
gedriickt  wird  und  das  Feld  Blinkrate  leer  war,  kann  entfallen.  Durch  die  Visuali- 
sierung  (OK-Knopf  grau)  erhalt  der  Benutzer  auBerdem  sofort  ein  Feedback  fiir 
seine  Aktionen.  Das  Datenbanksystem  "PHOENIX",  welches  bei  Application 
Systems  Heidelberg  vertricben  wird  und  ebenfalls  von  uns  entwickelt  wurde, 
macht  regen  Gebrauch  von  kontextsensitiven  und  nicht-modalen  Dialogfenstern. 

Nur  wenn  sich  der  Zustand  des  OK-Knopfes  andert,  muB  dieser  neu  gezeichnet 
werden,  da  es  sonst  zu  einem  stiindigen  Flackem  bei  jeder  Taste  kommen  wiirde. 
Dieser  Umstand  wird  durch  die  elegante  Formulierung 

if  ((*p  ==  EOS)  ==  ! is_state  (settings,  SOK,  DISABLED)) 

herbeigefiihrt.  Die  erste  Bedingung  gibt  immer  an,  wann  der  Knopf  ungiiltig  ist. 
Die  zweite  Bedingung  gibt  an,  ob  der  Knopf  gerade  giiltig  ist  (!  DISABLED).  Ist 
z.B.  die  Blinkrate  leer  und  der  Knopf  "schwarz",  so  ergibt  dies  TRUE  ==  TRUE. 
Genau  dann  ist  es  notig,  den  Zustand  des  Knopfes  zu  andern  (flip_state)  und  diesen 
neu  zu  zeichnen. 
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Das  gleiche  gilt  fiir  "Blinkrate  nicht  leer"  und  "Knopf  grau".  Dann  ist  die  Bedin- 
gung  FALSE  ==  FALSE  ebenfalls  erfullt  und  der  Zustand  muB  geandert  werden. 
Voraussetzung  fiir  das  Funktionieren  des  "flip_state"-Trickes  ist,  daB  der  Knopf 
vor  dem  Start  des  Dialoges  korrekt  eingestellt  ist.  Solch  eine  korrekte  Einstellung 
sollte  am  Ende  von  set_...  gemacht  werden  (in  unserem  Fall  set_settings). 


Hinweis:  Die  Funktionen  key_  und  click_  werden  vom  Modul  WINDOWS  indi- 
rekt  angesprungen  und  erhalten  zwei  Paramler  (window,  mk).  Oft  ist  es  ndtig,  in 
diesen  beiden  Funktionen  weitere  Informationen  Qber  das  Dialogfenster  zur  Ver- 
fiigung  zu  haben.  Was  "normalcn"  Fenstern  recht  ist,  sollte  Dialogfenstern  billig 
sein.  Auch  hier  ist  es  mogiich,  in  das  Feld  window->special  z.B.  einen  Zeiger  auf 
eine  Struktur  einzuhangen,  die  weitere  Informationen  beinhaltet.  Dieser  Zeiger  ist 
dann  in  den  key-  und  cHck-Funktionen  verfiigbar. 

Beispiel: 

typedef  struct 

{ 

WORD  exit_obj; 

WORD  blinkrate; 

} SET_SPEC; 

SET_SPEC  set_spec; 


window->click 
window->key 
window->s ho whelp 
window->special 


click_set tings; 
key_se things; 
help_settings ; 
(LONG) &set_spec; 


Und  in  click_...  heiBt  es  dann:  ’ zk' ‘ 

ll  ■<  4J11  V J-5  : * i • liTljV 

SET_SPEC  *set_spec; 


set_spec  = (SET_SPEC  * ) window->special ; 

LOCAL  BOOLEAN  help_settings  (WINDOW?  window,  WORD  icon) 

In  der  Help-Funktion  wird  nach  einem  vorhandenen  Hilfe-Fenster  gesucht.  1st 
keines  da,  so  wird  der  Objektbaum  auf  die  rechte  untere  Ecke  des  Bildschirmes 
gelegt.  Dort  stdrt  das  Hilfe-Fenster  am  wenigsten.  Dann  wird  der  Dialog  kreiert 
(crt_dialog). 

Bei  erfolgreichem  Erzeugen  wird,  wenn  das  Fenster  nicht  offen  war,  der  Arbeits- 
sowie  der  Scrollbereich  des  Hilfe-Fensters  ebenfalls  auf  den  rechten  untcrcn 
Bereich  des  Desktops  gesetzt.  Wiirde  man  das  nicht  tun,  so  wiirde  das  Hilfe-Fen- 
ster, wenn  es  einmal  geschlossen  wurde,  immer  an  der  alten  Position  crscheinen. 
Das  soli  beim  Hilfe-Fenster  aber  gerade  nicht  passieren. 


. , : ■ 
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Programmierung  von  Listboxen 


Das  Modul  Windows  wurde  um  die  Darstellung  von  Listboxen  erweitert.  Eine 
Listbox  besteht  aus  mehreren  Objekten.  Das  Wurzelobjekt  (ROOT)  ist  eine  Box, 
die  alle  Komponenten  einer  Listbox  enthalt.  Das  Objekt  ITEMS  enthalt  alle 
Textzeilen  einer  Listbox.  Das  Objekt  PARENT  ist  eine  Box,  die  die  Elemente  der 
Schieber  enthalt.  Er  wird  SLIDER  genannt,  die  beiden  Pfeile  heiBen  UP  und 
DOWN. 


Im  SCRAP-Programm  wurden  zwei  Listboxen  implementiert,  um  Zeichensatze 
bzw.  PunktgroBen  auszuwahlen.  Die  Objekte  der  Font-Listbox  beginnen  mit  SF... 
(SelFont),  die  der  PunktgroBen  mit  SS  (SelSize).  Beispiel  fiir  die  Font-Listbox: 


#define  SFROOT  3 
#define  SFITEMS  4 
#define  SFPARENT  12 
#define  SFSLIDER  13 
#define  SFUP  14 

#define  SFDOWN  15 


/*  BOX  in  tree  SELFONT  */ 

/*  BOX  in  tree  SELFONT  */ 

/*  BOX  in  tree  SELFONT  */ 

/*  BOX  in  tree  SELFONT  */ 

/*  BOXCHAR  in  tree  SELFONT  */ 
/*  BOXCHAR  in  tree  SELFONT  */ 


Um  weitere  Listboxen  in  anderen  Dialogboxen  zu  benutzen,  kopieren  Sie  sich  eine 
der  beiden  Listboxen  in  Ihre  Dialogbox  hinein.  Um  eine  Listbox  mit  der  Maus 
greifen  zu  kdnnen,  gehen  Sie  im  Resource  Construction  Set  wie  folgt  vor:  Driicken 
Sie  die  Control-Taste  und  schieben  den  gepunkteten  Bereich  des  Sliders  der 
gewiinschten  Listbox  um  ein  Zeichen  nach  links  (Dutch  das  Driicken  der  Control- 
Taste  erreichen  Sie  das  Objekt  SFPARENT).  Darunter  kommt  das  Wurzelobjekt 
(SFROOT)  der  Listbox  zum  Vorschein.  Diese  Objekt  konnen  Sie  greifen  und 
verschieben  Oder  kopieren.  Es  beinhaltet  alle  Objekte  der  Listbox.  Schieben  Sic 
zum  SchluB  den  gepunkteten  Bereich  des  Sliders  wieder  in  die  alte  Position. 

Das  Objekt  SFITEMS  kdnnen  Sie  selektieren,  wenn  Sie  die  Control-Taste  betati- 
gen  und  auf  irgendeine  Textzeile  in  der  Listbox  klicken. 

Achtung!  Sortieren  Sie  die  Listbox  nie,  da  sonst  die  bendtigte  Reihenfolge  der 
Objekte  nicht  eingehalten  wird! 

Nach  dem  Kopieren  von  Listboxen  geben  Sie  den  6 o.g.  Objekten  bitte  wieder 
neue  Namen.  Die  bendtigen  Sie  fiir  die  Initialisierung  der  Listbox. 

Die  Datenstruktur  LISTBOX  (WINDOWS.H): 

♦define  LIST_INIT  0x01  /*  Initialisiere  Listbox  */  ' 

♦define  LIST_DRAW  0x02  /*  Zeichne  Listbox  */ 

♦define  LIST  CLICK  0x04  /*  Klick  in  Listbox  */  ' 


typedef  struct 
{ 


WINDOWP 

window; 

/* 

Fenster  der  Listbox  */  . 

OBJECT 

*tr€€ ; 

/* 

Objektbaum  der  Listbox  */ 

VOID 

*itemlist; 

/* 

Liste  der  Structs  alter  Eintrage  */ 

SIZE  T 

itemsize; 

/* 

GroLe  eines  Elements  */ 

BOOLEAN 

indirect; 

/* 

Elemente  sind  Zeiger  auf  Zeichenketten  */ 

WORD 

num  items; 

/* 

Anzahl  verfiigbarer  Eintrage  */ 

WORD 

vis  items; 

/* 

Anzahl  sichtbarer  Eintrage  */ 

WORD 

width; 

/* 

Breite  eines  Eintrags  */ 

Programmierung  von  Listbaxen 
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WORD 

first  item; 

/* 

Erster  Eintrag  in  Listbox  */ 

WORD 

active; 

/* 

Aktiver  Eintrag  in  Listbox  */ 

UWORD 

sel  state; 

/* 

Status,  mit  dem  selektiert  wird  */ 

WORD 

root  ; 

/* 

Ob jektnummer  der  Listbox  */ 

WORD 

items; 

/* 

Ob jekt nummer  der  Box  mit  Eintragen  ♦/ 

WORD 

up; 

/* 

Ob jektnummer  des  Hoch-Pfeils  */ 

WORD 

down  ; 

/* 

Objektnummer  des  Unten-Pfeils  */ 

WORD 

parent; 

/* 

Objnummer  des  Elternteils  des  Sohiebers 

WORD 

slider; 

/* 

Objektnummer  des  Schiebers  */ 

} LISTBOX,- 


Bemerkungen: 

Das  Feld  "itemlist"  enthalt  die  Texte  aller  Eintrage.  Die  Texte  konnen  auch  aus 
Strukturcn  bestehen,  die  weitere  Informationen  neben  den  Texten  enthalten  kon- 
nen. Im  Font-Beispiel  sind  die  Texte  in  "fnames"  direkt  gespeichert.  Der  zugehd- 
rige  Speicher  wird  dynamisch  alloziert  und  freigegeben,  wenn  das  Dialogfenster 
wieder  geschlossen  wird.  Die  Texte  in  "itemlist"  konnen  breiter  sein  als  der  Platz, 
der  in  der  Dialogbox  reserviert  ist.  Die  Zeichenketten  werden  vor  der  Ausgabe 
entsprechend  gekurzt. 

Bei  spiel  fUr  eine  Struktur; 

typedef  struct 

{ 

LONG  Nummer; 

BYTE  Name  [40  ] ; ' . i;''' 

BYTE  Ort  [20];  ' ^ ,! 

} KUNDE; 

. i 

KUNDE  kunden  [100]; 

Die  Initialisierung  fiir  eine  Namensliste  muB  wie  folgt  aussehen: 
fnames . itemlist  = kunden  [0].Name; 

fnames  . itemsize  = sizeof  (KUNDE);  lu  >l  iun:,- j-'-i!  .{1111“^ 

fnames . indirect  = FALSE; 
f names . num_items  =100; 

Sind  nicht  die  Namen,  sondern  nur  Zeigerauf  die  Namen  in  der  Struktur  abgelegt, 
so  muB  das  Flag  "indirect"  auf  TRUE  gesetzt  werden.  Bcispiel: 

typedef  struct 

{ '■  ■ ■ ^ ■ 

LONG  Nummer; 

BYTE  *Name;  , . 

BYTE  *Ort;  . ■ ■■ 

} KUNDE; 

KUNDE  kunden  [100]; 


fnames . indirect  = TRUE; 

Das  Feld  "sel_state"  enthalt  den  Status,  der  benutzt  werden  soil,  wenn  eine  Zeile 
selektiert  wird.  Man  wird  CHECKED  Oder  SELECTED  benutzen.  CHECKED 


570 


Anhang  C.  Die  neue  Software 


zeichnet  eiii  Hakchen  vor  das  selektierte  Objekt  (Namen  sollten  aus  Platzgrtinden 
mit  zwei  Leerzeichen  beginner).  SELECTED  invertiert  die  aktuell  angewahlte 
Zeile. 

Initialisierung  fiir  das  FONT-Beispiel:  (siehe  MENU.C) 

wnames  = selfont  [3FITEMS ) . ob_width  / gl_wbox; 
size  = wnaines  + 1;  /*  EOS-Zelchen  */ 

if  (fnames  ==  NULL) 

fnames  = mera_alloc  ( (LONG)  r.ura_  fonts  * size); 

Inames . window  = search_window  (CLASS_DIALOG,  ' 

SKCH_ANY,  SELFONT);  , i 

Ir.araes.tree  = selfont; 

Inames . itemlist  = fnames; 

Inames . itemsize  = size; 

Inames . indi rect  - FALSE; 

Inames  . num_items  =■  num_fonts; 

Inames . first_item  = (inx  >=  nlines)  ? inx  : 0; 

Inames . active  = inx;  ■ 

Inames . sel_state  = CHECKED; 

Inames. root  = SFROOT; 

Inames . items  = SFITEMS; 

Inames.  up  = SF'JP; 

Inames. down  = SFDOWN; 

Inames . parent  = SFPARENT; 

Inames . slider  = SFSLIDER; 

if  (fnames  !=  NULL)  set_lnames  (num_fonts); 
listbox  (Slnames,  LIST_INIT,  NULL); 

1st  die  Struktur  belegt,  so  ruft  man  listbox  mit  dem  Befehl  LIST_INIT  auf.  Der  3. 
Parameter  ist  ein  Zeiger  auf  die  Struktur  MKINFO  und  wird  nur  bei  LIST_CLICK 
benotigt.  In  obigem  Beispiel  setzt  die  Funktion  set_lnames  noch  die  Namen  der 
Fonts  in  das  Feld  "itemlist". 

Nachdem  die  Listbox  initialisiert  ist,  mu6  sie  auf  Mausaktionen  reagieren.  In  der 
Funktion  click_font  wird  dies  wie  folgt  erreicht: 

if  ((SFROOT  <=  wi ndow->exit_ob j ) 

(window->exit  ob j <”  SFDOWN) ) 

( 

active  = Inames .active; 

dclick  = listbox  (filnames,  LIST_CLICK,  mk); 
set_for.ttable  (font_table  [ Inames  . active]  ) ; 

if  (active  Inames . active) 

] 

Isizes . f irst_item  = 0; 

Isizes .active  = 0; 
sel_point  = point_table  [0); 

nura_points  = 0 ; 

while  (point_table  [num_points]  !=  0)  num_points  + + ; :r  : 1 

set_lsizes  (num  point. s) ; 

listbox  (Slsizes,  LIST_INIT  I LIST_DRAW,  mk) ; 
draw_font  (window) ; 

} /»  if  */ 

} /*  if  */ 

Zunachst  wird  getestet,  ob  sich  das  exit_obj  im  Bereich  der  Fontliste  befindet 
(SFROOT  bis  SFDOWN),  Dann  merken  wir  uns  den  alten  selektierten  (aktiven) 
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Wert,  um  spater  testen  zu  konnen,  ob  der  Benutzer  ein  anderes  als  das  schon 
selekiierte  Objekt  angewahlt  hat. 

Jetzt  wird  die  Funktion  listbox  aufgerufen.  Der  Befehl  ist  LIST_CL1CK  mit  den 
aktuellen  Mausinformationen  (mk).  Man  erhalt  zuriick,  ob  ein  Doppelklick  auf  ein 
selektiertes  Objekt  angewendet  wurde.  Die  ZeichensatzgroGen  fiir  den  neuen 
selektierten  Font  werden  berechnet. 

Wurde  ein  neuer  Font  gewahlt  (ative  !=  Inames. active),  so  wird  die  Listbox 
"Isizes",  die  ja  die  PunktgrdBen  enthalt  mit  den  GrbBen  des  neuen  Fonts  initiali- 
siert,  die  Texte  gesetzt  (sei_lsizes)  und  die  Listbox  sowohl  initialisiert,  als  auch 
neu  gezeichnet  (LIST_INIT  I LIST_DRAW).  Der  Beispieltext  wird  ebenfalls  neu 
gesetzt  (draw_font). 

Schauen  Sie  sich  bitte  die  Funktion  draw_font  genauer  an,  falls  Sie  in  Dialogboxen 
etwas  zeichnen  mdchten,  was  Sie  nicht  in  der  Resource-Datei  anlegen  konnen.  Sie 
mtissen  dann  Ihre  Zeichenfunktion  in  die  Fensterstruktur  der  Dialogbox  einhan- 
gen.  In  mselfont  wird  dies  mit 

window->draw  = draw_font 

realisiert.  In  der  Funktion  draw_font  darf  das  Clipping  nur  gesetzt  werden,  wenn 
es  sich  um  das  oberste  Fenstcr  handelt,  sonst  wird  das  Clipping  ja  durch  das  redraw 
vom  Window-Manager  automatisch  gesetzt.  Man  muB  es  setzen,  wenn  das  Fenster 
oben  ist,  da  nach  einem  Scrollen  oder  Klicken  in  eine  Listbox  das  Clipping  von 
der  Listbox-Funktion  verstellt  wird. 


Zusatz  zur  Bedienung  von  SCRAP 

Die  Meniileiste  enthalt  jetzt  unter  dem  Menii  "Optionen"  die  Meniipunkte 

Schriften  laden 
Schriften  freigeben 
Schriftauswahl... 

Die  Texte  wurden  komplett  ins  Deutsche  ubersetzt  (ehemals  Fonts  laden  usw.). 

Fall  Sie  GDOS  installiert  haben,  sollten  Sie  Schriften  laden,  um  besser  mit  dem 
neuen  Dialogfenster  "Schriftauswahl"  experimentieren  zu  konnen. 

Das  Dialogfenster  "Schriftauswahl"  ist  ein  sogenannter  nicht-modaler  Dialog. 
Nach  der  Anwahl  des  Meniipunktes  "Schriftauswahl...”  erscheint  das  Fenster  in 
der  Mitte  des  Bildschirms.  Dort  konnen  Sie  mit  der  Maus  eine  neue  Schrift  oder 
eine  andere  SchriftgroBe  auswahlen.  Ein  Beispieltext  zeigt  sofort  die  Auswahl  an. 

Fuhrt  man  einen  Doppelklick  auf  eine  Schrift  oder  eine  PunktgroBe  aus,  so  wird 
das  Dialogfenster  mit  "OK"  verlassen. 

Die  ausgewahlte  Schrift  wird  benutzt,  um  das  nachste  noch  nicht  gedffnete 
"Power”-Fenster  damit  anzuzeigen.  Ein  geoffnetes  "Power"-Fenster  behiilt  die 
Schrift,  mit  der  es  zum  erstenmal  gebffnet  wurde,  bei. 
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Da  die  Schriftauswahl  nicht-modal  ist,  kann  man  mit  der  rechten  Maustaste  die 
Knopfe  driicken,  ohne  das  Fenster  zu  schlieBen.  Driickt  man  also  mit  der  rechten 
Maustaste  auf  "OK",  so  wird  die  gewahlte  Schrift  und  GrdBe  ubernommen  und  fiir 
das  nachste  "Power"-Fenster  benutzt.  Driickt  man  mit  der  rechten  Maustaste  auf 
"Abbruch",  so  wird  die  letzte  Einstellung  zuriickgeholt.  Ein  Klicken  mit  der 
rechten  Maustaste  auf  die  Knopfe  eines  nicht-modalen  Dialogfensters  bewirkt  also 
das  gleiche  wie  mit  der  linken  Taste,  ohne  jedoch  den  Dialog  zu  beendcn. 

Experimentieren  Sie  doch  damit,  daB  Sie  in  der  Funktion  mselfont  im  Modul 
MENU.C  statt  Wl_MODELESS  ein  WI_MODAL  schreiben  und  die  Auswirkun- 
gen  beobachten. 

Die  ausgewahlte  Schrift,  sowie  die  SchriftgroBe  werden  im  special-Wert  der 
"Power"-Window-Struktur  im  zweiten  sowie  dritten  Byte  abgelegt. 
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Stichwortverzeichnis  ' 


Accessories  12,  15,  96,  119,  183,  303, 
335,  341,  365,  383,  402,  434,  447, 
456,  458,  462,  485,  490 

ac close  123 

ac_open  123 

addr in  104  U',  r - 

addr out  104 

AES  18,  25,  42,  80,  96,  162 
AES-Binding  104  . s, 

AES.H  331,  407,  496 
akustischer  Abbildspeicher  292 
Alcyon  C 13,  379 
Alertbox  141 
Alternate-Taste  146 
ANSI-C  14 

ANSI-C-Compiler  339,  343,  361,  383 
ANSI-Standard  211 
any_open  430 

appi bvset  117,  119 

appl exit  53,  117 

appl find  117f. 

Application-Library  99,  116 
Applikation  96 

appl init  117 

appl read  I17f. 

appl tplay  117f.  s,; 

appl trecord  117f. 

appl write  117f. 

appl_yield  98,  117,  119 

Arbeitsgerat  51,  57 

Arbeitsstation  28,  32,  39,  53,  59,  61 

array2rcct  417 

array2xywh  417 

arrow-mouse  403,  408 

arrow window  437 


ASCII-Code  120 
ASCll-Dateien  14 
aspect  ratio  59 

ASSIGN.SYS  19,  27,  29,  31ff.,  35,  39, 
42,  52,  57,  62,  95 
Assoziationen  294f. 

Atari  11 

Atari  ST  12f.,  15,  18f.,  21,  23,  33,  41,  56 
Atari  TT  12,  41 
Attribute  28,  64 
Attribute-Funktionen  29,  67 
Aufmerksamkeit  313 
Ausgabedatei  183 
Ausgabefiinktionen  29,  63 
Ausgabegerat  39,  55,  57,  59 

background  411 

benutzerdefinierte  Objekte  132,  286 
Betriebssysteme  215 
Bezier-Funktionen  186 
Bildschirm  25,  28, 32, 43, 55, 59, 61ff. , 74 
Bildschirmauflosung  12,  58 
Bildschirmfenster  24,  63 
Bildschirmmanager  97,  121,  126,  153 
Bildschirmspeicher  77 
Bildschirmtreiber  34 
Bindings  40,  42,  51 
BIOS  18,  23 
Bit-Image  25,  79 

Bit-Image-Datei  27,  82,  183,  330,  333, 
335,  340,  355 
Bit-Image-Files  14 
Bit-Image-Format  198 
blink  414 

busy mouse  403,  408 
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CALCLOCK  61 
CALCLOCK.ACC  123 

click window  441,  453 

Clipboard  147,  306,  329ff.,  371,  405 
CLIPBRD  147,  354,  370,  373ff.,  423, 
430,  441.  445,  464.  482 
clipping  63,  114 

close all  434 

close dial  412f. 

close top  434 

close vwork  406 

close window  402  , 433 

closc_work  407 

clr area  446  * 

clr_bottom  446 
clr_left  446 

clr right  446 

clr scroll  446 

clr top  446 

clr work  446 

Compiler  215 
contrl  39,  42,  51 
control  104 
Control-Taste  146 
Copy  147 

crcate_windows  432 

crt clipbrd  466f. 

crt desktop  462f. 

cru_disk  468 

crt edit  475 

crt graf  478 

crt image  472 

crt_meta  473 
crt_module  481,  484 

crt power  477 

crt printer  469 

crL_trash  471 
Cut  147 


Dateiauswahl-Box  304f,,  405,  427 
Datcnaustausch  328,  333 
Datentypen  210 
DCHECKBOX  133 

delete window  432,  434 

Deskaccessories  303,  373,  402 
Desktop  18,  20,  43,  51f.,  55,  354,  373fT., 
423,  441,  445,  452,  460 
Desktop-Fenster  109,  150 
DESKTOP.  INF  76,  383 
DREADER  133  . ./r 


Dialogbox  111,  115.  309,  312f„  318f., 
321ff..  364,  412 
Dialog-Funktionen  411 
Digital  Research  288 
Digital  Research  C 13,  222,  379,  523 
DISK  354,  468 
Dispatcher  97 

do flags  409 

do state  408 

drag boxes  444 

drag__to window  440 

DRAW3D  132 
draw  func  461 
diaw_key  461 

draw mbar  447 

draw mtitle  447 

draw object  444 

draw_window  434 
DRBUTTON  133 
Drop-Down-Menii  115 
Dnicker  19,  25,  28,  32,  43,  55,  59,  61, 
6.3,  69f.,  85ff. 

Druckerspooler  123 

DUMPGEM  186  v. 

Dutch  33  • A 

EDIT  355,  368,  370f.,  374,  376, 

402,  475  t 

Eingabe-Funktionen  30,  80 
Entwicklungsumgebungen  209 
environment  159  A 

Ereignisse  99,  110,  120  - 

Erkennungssystem  290f.,  293 
error  420 
Error-Box  142 

Escape-Funktionen  30,  42,  84  (■ 

EVENT  353ff.,  368,  399,  430,  436f„ 
442,  448,  451,  459,  479,  482 
Event-Library  99,  119 

evnt button  119,  121 

evnt dclick  119,  125  i 

evnt event  451 

evnt__keybd  119f. 

evnt mesag  119,  121 

evnt mouse  119,  121 

evnt multi  119f,,  125,  368,  444, 

451f.,  482 

evnt ^timer  119,  125  (i 

Exponentialgesetz  der  Ubung  312  ’-s 

EXPORT.H  397 

Extended-Graphics-Library  103,  161 
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Farben  58,  69.  76,  199 
Farbpalette  200 
Fehleraufhebung  325 
Fehlerbehandlung  324,  419 
Fehlermcldung  115 
Fehlervemieidung  324 
Fenster  17,  102,  112,  150 
file ^exist  426 

File-Selector-Library  102,  149 
file split  425 

find desk  460  , 

find flags  410 

find state  409 

find top  430 

find window  430 

FlexOS  11,  13,  22,  215,  232,  301,  305, 
308,  317,  378f.,  383,  388ff.,  395, 

398,  488,  535 

flip flags  410 

flip state  409 

form alert  140L,  143 

Formate  183 
form_button  140,  144 
fonn_center  111,  140,  143 
form_dial  lllf.,  140,  142 
forni_do  111,  140,  142,  413 
form_error  140,  142f, 
fomuJceybd  140,  144 
Form-Library  100,  140 
Formular  140 

fsel exinput  149f. 

feel input  149 

full window  439 

Fundamentalprinzip  der  Aufgaben- 
analyse  300 

GDOS  19,  21,  25ff.,  31f,  42,  56, 

97,  284 

GDOS.PRG  27 
GDP  42 

GEM  5,  Ilf.,  14,  17ff.,  22.  301ff.,  311, 
318fzf.,  322,  335,  341,  402,  451 
GEM  2.x  329ff.,  334,  374 
GEM/3  11,  21,  29,  35,  39,  42f.,  46, 

47,  55f.,  59f.,  62,  64ff.,  73,  82, 

86ff.,  94f.,  116,  128,  143,  329ff., 

354,  405,  464f. 

GEM  3.x  147 

GEMAIN  353,  355,  397,  455 
GEM-Desktop  157 

GEMDOS  13,  18,  23,  52,  215,  221,  333, 


379,  383,  387,  395f.,  399,  488,  523 
GEMFILE.GEM  53,  91 
GEM -Output  53 
GEM-Versionen  215 
Gerateformat  77 
Geratekennung  28,  31,  39,  42 
geratespezifisches  Format  30,  74,  79 
Geratetreiber  27,  35 
Gesetz  der  Ubung  296 
Gesetz  von  Fitt  309 

get border  444 

get clipxywh  465 

get dxywh  460 

get path  426 

get ^ptext  410 

GLOBAL  104,  353,  400,  455 
GLOBAL.H  371 
GOMS-Modell  314 
GRAF  355,  374,  478 

graf dragbox  144,  445 

graf growbox  144f.,  161,  419,  444 

graf_handle  34,  52,  108,  144,  146,  401 
Grafiktablett  25,  28,  32 
grafische  Benutzeroberflache  5 

graf mbox  144f.,  210 

graf mkstate  120,  144,  146 

graf mouse  144,  146 

graf movebox  145,  210 

graf rubberbox  144 

graf rubbox  144 

graf shrinkbox  144L,  161,  419,  444 

graf slidebox  I44f. 

graf_watchbox  144f. 

Graphics-Library  101,  144 
GRC  14.  163 
growbox  419,  439 
G_USERDEF  132 

handle  28 

help clipbrd  467 

help desktop  464 

help__disk  469 

help edit  476 

help graf  480 

help-image  473 
help__meta  474 

help module  483 

help power  478 

help printer  470 

help trash  471 

Hick’s  Gesetz  296 
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hide mouse  403,  408 

High  C 236,  388,  535 
Hilfesystem  325 

hndl button  453 

hndl_dial  413 
hndl_events  452 
hndLJceybd  452 
hndl_ml  453 
hndl_menu  459 

hndl mesag  454 

hndl timer  454 

Hochformat  87 
HOTCLXOSE  152 
h_slider  437 

IBM  11 

IBM-PC  13,  15,  17,  20f., 
Icon  17,  79 

icons clipbrd  466,  481 

icons module  481 

Icon-Technik  306 
IMAGE  354,  472 
IMPORT.  H 391 

into clipbrd  467 

info desktop  463 

info disk  468 

info edit  476 

info graf  479 

info image  473 

info meta  474 

info module  483 

info power  477 

info printer  470 

Information  Hiding  341 

info trash  471 

init clipbrd  468 

init desktop  464 

init disk  469 

init edit  476 

INITERM  354f.,  454 

init global  427 

init graf  480 

init image  473 

init initerm  404,  454 

init menu  459 

init__meta  475 
init  module  484 

init power  478 

init printer  470 

init resource  456 

init trash  472 


o:-**  


23,  32,  41 


init windows  432,  455  ? 

inside  417 
Interferenz  295 

Intcrferenz  im  Kurzzeitgedachtnis  298 
Interferenz  im  Langzeitgedachtnis  298 
intin  39,  42,  51,  91,  104 
intout  39,  42,  51,  104  ■ 

is menu key  415,  449,  453  . i' 

is_top  430 

Kamera  19,  25,  28,  32,  61 
key_all  442,  453 
Keystroke-Level -Modell  314 

key window  442 

Klemmbrett  14,  147,  306,  329,  339 
Kommandozeile  158 
Kontrollfeld  76 
Kontroll-Funktion  28,  57 
Koordinatensystem  26,  51ff.  '■ 

Kurzzeitgedachtnis  291ff,,  297ff.,  302, 
311,  314,  318,  323 


Langzeitgedachtnis  291,  293 ff.,  297, 

299,  325 

User  C 224,  380,  387,  524 

last mouse  407 

Uttice  C 13,  226,  381,  526 
Lernprinzip  296  , , 

Macintosh  288,  311,  322,  325,  328 
make  14,  224 

Mark  Williams  C 13,  228,  382,  399,  527 

maBstabsgercchte  Zeichnung  59  , i 

Maus  25 

Mausform  146 

Mausfiinktionen  407 

Mausknopfe  121 

Megamax  User  C 13  ; 

mem ^alloc  420  '*  ■ ■■  ■■  ■ 

mem_avail  421 

mem free  420 

mem Imove  422 

mem Iset  421  < > 

mem move  421 

Memory  Form  Definition  Block 
(MFDB)  73 

mem set  421  ^14  'f  > 

Mengenfunktionen  422 
Mensch-Maschine-Schnittstelle  289 
Menii  294,  302f„  312,  316ff.,  354f.,  ■:» 
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370ff.,  375ff.,  412f.,  415  , - 

423,  429ff.,  447,  458  i 

menu bar  126,  183 

menu__center  111  ' ■ 

menu click  126,  128 

menu icheck  126 

menu iecheck  126  'iAir-J' 

menu ienable  112,  126f. 

menu_key  449 
Menu-Library  99,  126 

menu manager  447 

menu normal  447 

Meniipunkte  303,  315  f. 

menu register  126f.,  402 

menu text  126 

menu tnormal  112,  126f.,  447 

menu unregister  126f.  • 

: Menuzeile  109,  111,  126 

; META  355,  473 

I Metadatei  19,  25,  27f.,  28,  32,  39,  43, 

i 51ff.,  59,  61,  70,  90,  96,  148, 

f 183,  186,  198,  330,  333,  335,  340,  355 

I Metadatei-Format  25 

^ Metadatei-Treiber  33 

i Metawarc  High  C 13 

i Microsoft  C 13,  232,  384,  530 

i mn selected  122 

[ Modul  341f.,  344,  375,  390 

i MODULE  480 

Modus  317f,,  320 
Motiv  5 

motorische  Systeme  290,  292 
Motorsystem  293 

move window  440 

MS-DOS  13,  23,  42,  51,  56,  78,  215, 

232,  301,  317,  378,  383f., 

395f.,  399,  405,  488,  530 
MS-Windows  18 
Multitasking  11,  15,  22,  319 
Multitasking-Betriebssystem  21 
Multiuser-Betriebssystem  21  ^ 


i 

S Nachfragefunktionen  30,  81 

[ Nachricht  110,  117,  121 

I NDC-Koordinatensystem  43 

! normalisierte  Geratekoordinaten  26 

f Normalized  Device  Coordinates 

; NDC)  26 

! note  419 

! num windows  431 
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ob flags  131  if 

objc add  128,  138 

objc_change  112,  128,  140 

objc delete  128,  138 

objc_draw  llOf.,  128,  139 

objc edit  128,  139 

obJc_find  112,  128,  139 
objc_offset  128,  139 

objc order  128,  139 

objc rect  411 

Object-Library  99,  128 
Objekt  130 

Objektbaum  115,  128,  138 
Objektfunktionen  408 
ob_spec  131 
ob_state  lllf.,  131,  140 

ob type  131 

open clipbrd  467 

open desktop  463 

open dial  412f. 

open disk  468 

open edit  475 

open graf  479 

open image  472 

Open-Look  5 

open mcta  474 

open module  483 

open power  477 

open printer  470 

open trash  471 

open vwork  406 

open window  433,  463,  467 

open_work  407 
Open-Workstation  29 
OS/2  11,  22,  215,  383,  388 
OUT-Datei  86,  335 
OUT-Dateiformat  207 
OUTPUT  19,  27,^54,  61,  86,  90, 
123,  198 

OUTPUT.  APP  333ff. 

PapiergrdBe  54 
Parameter-Block  40f. 
Parameterubergabe  39 
PARMBLK  134 
Paste  147 

path exist  426 

pb type  132 

Piktogramm  17,  25,  78f.,  109,  112 
Pixelbreite  59 
Pixelgrafik  93,  198 
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PixelgroBe  54  * 

Pixdhohe  59 

Plotter  19,  25,  28,  32,  43,  55,  61 
Pop-Up-Menii  15,  17,  310f.,  323f.,  340, 
353,  355,  403,  407,  412,  414f., 

449,  477,  489 

PORTAB.H  215,  345,  347,  491 
Portabilitat  209 
POWER  355,  373f.,  476,  482 
Presentation  Manager  5,  22 

print clipfiles  466 

PRINTER  354,  469 
Prinzip  der  spezifischen 
Verschliisselung  295,  299 
Prinzip  de.s  Problemraums  300,  313 
Programmer’s  Toolkit  5f.,  384 
Prototyp  214,  343,  350,  388f. 

Prozefi  98,  117,  119,  121 
Prozessoren  215 
ptsin  39,  51,  91 
ptsout  39,  42,  51 
Pull-Down-Mcnii  17,  25 
Punkteregel  302 

Querformat  87 

Raster  Coordinates  (RC)  26 
Rasterfunktionen  30,  73 
Rastersystem  43 
Rationalitatsprinzip  300,  314 

rc copy  416 

rc equal  416 

rc intersect  416 

RCM  163,  175,  353f.,  451 
RCS  115 

rc union  416 

Rechteckfunktionen  416 
Rechtecklisten  113 
rect2array  417 
rect2xywh  418 

redraw window  435 

RESOURCE  354,  406,  411,  420,  456 
Resource-Construction-Set  109,  115, 

128,  155 

Resource-Datei  78,  108,  162 
Resource-Library  103,  155 
Resourcen  162 

rsc create  456 

rsrc_frec  155 

rsrc gaddr  109,  155f. 

rsrc_load  109,  116,  155,  175,  428,  457 


rsrc obfix  155,  157 

rsrc saddr  155,  157 

Scan-Code  120 
Schieber  113 

Schreibmodus  65,  67,  71 
SCRAP  6 
scrap_clear  465f. 

Scrap-Library  101,  146 

scrap read  465 

scrap write  465 

scroll_area  445 
scrollcn  79 
scrolling  73 

scroll window  436 

scrp„clear  149,  331 

scrp read  148,  331f. 

scrp write  148,  331ff.,  465 

search window  429,  483  ;>,* 

Seitenbreite  61,  198 
SeitengroBe  185 
Seitenhohe  61,  198 

Seitenverhiiltnis  59  r . 

select file  427 

setall  423 

setand  424  tf 

sctcard  425 

set clip  402,  418 

setclr  423  , ,, 

setemp  425  /,• 

setepy  423  f,<{ 

set ^deskinfo  461 

setexcl  424 

set func  461 

setin  425 
setind  424 

set meminfo  462 

set mouse  407 

setnot  423  ’,5 

setor  424 

set path  426  ; j, 

set ptext  410 

set_redraw  447 
set sliders  438 

setxor  424  I,' 

shel envrn  157,  159  < 

shel_find  157,  159  ir 

Shell-Library  103,  157  / 

shel_ndef  157,  160,  334 
sheLread  157f.,  334,  399,  404,  428  n 
shel_wdef  157,  160,  334 
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shel_write  157f.,  333f.,  455f.  : 

Shift-Taste  146  ~ v 

SHOWGEM  240 

show mouse  403,  408 

shrinkbox  419,  439 
size_window  440 
Slider  113 

snap window  438,  440 

Speicherfunktioncn  420 
Standardformat  30,  74,  77,  79,  329f. 

str lower  422 

str^ upper  422 

Style  Guidelines  5f. 

Swiss  33 

Systemzeichensatz  401 

term_clipbrd  468 

term disk  469 

term global  428 

temu^raf  480 
term  image  473 
term__initenn  404,  455 
term__menu  460 
term__meta  475 
tcniL_moduIe  484 
term_power  478 

term printer  470 

term resource  458 

temL_trash  472 
term  window  451 
Textattributc  207 

timer all  443 

timer window  443 

Toolkit  5 

top window  435,  463 

TOS  18f.,  23 
TOUCHEXIT-Flag  142 

trans gimage  411 

Transputer-Workstation  17 
TRASH  354,  470 
Treiber  31,  39 
Thrbo  56 

Turbo  C 13,  229,  235,  383,  386,  399, 

529,  532 

Typuberpnifung  211 

tibung  312f. 

unclick window  442 

Undo  306,  325 

undo flags  409 

undo state  409 


Unentschlossenheit  315 
UNIX  14,  17,  22 
Unsicherheitsprinzip  296,  315 
Unterscheidungsprinzip  295,  298 

untop window  435 

updt menu  458 

USERBLK  134 

V  alpha text  84,  86 

V  arc  64 

V  bar  64 

V  bit image  84,  93,  186 

V  cellarray  64 

V  circle  64 

V  dear disp list  84,  86 

V  cirwk  61,  85 

V  dsvwk  53,  62 

V  dswk  54,  57,  61 

V  contourfil]  64 

v_copies  84,  87 

V  curdown  84 

V  curhome  84 

V  curleft  84 

V  curright  84 

V  curtext  84 

V  curup  84 

VDI  18,  24f.,  27f.,  39f.,  42f.,  51f.,  95 

VDI.H  335,  511 

vdi handle  55,  57,  62 

V  dspcur  84f. 

V  ecol  84 

V  eeos  84 

V  ellarc  64 

V  ellipse  64 

V  ellpie  64 

V enter cur  84 

V  etext  64f. 

vex_butv  80f. 
vex_curv  80f. 

V. exit cur  84f. 

vex  mntv  80f. 
vex timv  80f. 

V  fillarea  64 

V  form_adv  84 

V  form  advance  85 

V  gct„driver info  35 

v get pixel  73 

V  gtext  55,  64 

v hardcopy  84f. 

V  hide c 52,  80 

visueller  Abbildspeicher  291  f. 
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V  justified  64,  66  • 

V  marker  64 

vm coordinates  51 

vm coords  45,  54,  56,  90,  92 

V  meta extents  54,  56,  85,  90 

vm filename  85,  90f. 

vm pagesize  45,  51,  54,  56,  92 

V  ^opnvwk  57,  62 

V  opnwk  39,  52f.,  55,  57,  62,  108, 

146,  184 

Vorhersehbarkeit  315,  323 

V  orient  84,  87 

V  output window  84,  86 

V  pieslice  64 

V  pline  64 

V  pmarker  64 

vq ccllaray  81 

vq chcells  84 

vq color  81  .. 

vq curaddress  84  , 

vq extnd  77,  79,  81f.  v 

vqf attributes  81 

VQ_GDOS.S  222 

vq inmtxie  81  i 

vq_key_s  80  ■ nr,  .v 

vql attributes  81  - . 

vqm attributes  81 

V  qmouse  80 

vqp_error  89  i, 

vqp_filmname  84,  89 
vqp films  89 

vqp state  89  . , 

vq scqan  84  hi  ■ 

vq tabstatus  84  • , 

vqt attributes  81  M -jjr  ’ i,.  '- 

vq tdimensions  84  i-'j  _ .ryiiw,  ,• 

vqt extent  81f.  y 

vqt font info  81 

vqt justified  81  -v.  ,• 

vqt name  81,  83  , , 

vqt width  81  , •%  , , , , ,, 

v rbox  64  , 

v_rmcur  84f. 

vro cpfm  82 

vro cpyfm  73,  78,  80 

vrq choice  80  '..nr!  . 

vrq locator  80  . ,y..  , 

vrq string  80  t-y  : =,1-, 

vrq valuator  80 

vr recfl  64 

vrt cpyfm  73,  79  ^ , 


vr tmfm  73,  77ff.,  109  l « 

v rvoff  84  ; -..jj, 

V rvon  84  t, 

vse expose  85,  89 

vse form  80 

vs clip  57,  63 

vs color  68f. 

vs curaddress  84 

vsf color  65,  68 

vsf inferior  65 

vsf interior  68,  71 

vsf perimeter  65,  68,  73 

vsf style  65,  68,  71 

vsf updat  68  r > 


V show c 80  j ? 

vsin__mode  80f. 

vsl color  64,  68  * 

vsl ends  64,  68  , 

vsl type  64,  68 

vsl udsty  68  . 

vsl width  64,  68  , . 

vsm choice  80  , 

vsm color  64,  68  ii 

vsm height  64,  68  - 

vsm locator  80  , - , 

vsm_string  80  , _ , . , 

vsm type  64,  68  . 

vs mute  84,  88 

vsm valuator  80  < - i .;>  •.!  i- 

v sound  84,  88,  419  - ..-r 

vs_palette  84  . i 

vsp_film  84,  89 
vsp message  89 

vsp save  89  ; . 

vsp state  89  ,,, 

vst alignment  65,  68,  70 

vst color  54,  68,  70  -,f 

vst effects  54,  65,  68,  70 

vst ex load fonts  57,  63 

vst font  54,  65,  68,  70,  83  ; i 

vst height  65,  68  j 

vst load font  39  ■ 

vst_Joad_fonts  53,  57,  70,  83  vi 

vst point  55,  65,  68f. 

vst rotation  55,  65,  68  , i 

vst — unload fonts  53f.,  57,  63 

vswr mode  54,  65,  68,  71  Vi 

vt alignment  84 

vt axis  84  . . , . r ■ 

vt — origin  84  t'Vv  ■ana. 

V tr^  84,  88  i., 
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vt resolution  84 

V  updwk  53,  57,  61,  86 

V  write__meta  85,  90 

V  xbil image  85,  93 

Wahmehmungs^stem  290f.,  293 
WHITEBAK  132 

wind apfind  373,  440 

wind calc  150,  154  ' ’ 

wind close  114,  150,  152 

wind create  112,  150f.,  433 

wind_delete  114,  150,  152 

wind find  150,  153 

wind get  110,  150,  153 

wind new  150,  154 

wind open  113,  150,  152 

Window-Library  102,  150 
WINDOWS  353,  355,  357,  402,  428 
WINDOWS.H  357,  362  , 370,  372f. 
wind_set  110,  113,  150,  153 

wind update  114,  150,  153 

wm arrowed  122 

wm closed  122 

wm ftilled  122 

wm hslide  123 

wm moved  123 

wm redraw  122 


wm ^sized  123 

wm topped  122 

wm untopped  123 

wm vslide  123 

Wotdplus  86 
workstation  28 
writing  mode  67 

XBIOS  18,  23 
XBRA-Protokoll  336 
Xerox  289 

X/GEM  Ilf.,  21f.,  39,  137,  209,  301, 
303,  308,  319,  329f.,  332,  365,  383, 
388ff.,  398ff.,  412,  427,  451f., 

455,  460 

xgrf 2box  161 

xgrf stepcalc  161 

X-Window  5,  17 
xywh2array  417 
xywh2rect  418 

Zeichenkettenfunktionen  422 
Zeichensatz  27,  31,  35,  39,  51,  53,  57, 
62  , 70,  83 
Zeichenzellc  69 
Zwischenablage  147,  306 
Zykluszeit  291 
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Die  Autoren: 

Wir  wurden  als  eineiige  Zwillinge  am  4.6.1958  in  Heidelberg  geboren.  1980  begannen 
wir  mit  dem  Studium  der  Informatik  an  der  Universitat  Karlsruhe,  das  wir  im  Februar 
1988  als  Diplom-Informatiker  abschlossen.  Von  1986  bis  Anfang/Mitte  1989  entwickelten 
wir  das  bekannte  Datenbanksystem  ADIMENS  ST.  Jetzt  arbeiten  wir  bei  der  BASF  AG 
als  Informatiker.  Unser  Wunsch,  komplexe  Software  fiir  den  Endanwender  durch  den  Ein- 
satz  von  grafischen  Benutzeroberflachen  bedienbar  zu  machen,  ist  dort  auch  eines  unserer 
vorrangigen  Ziele. 

Wahrend  der  letzten  2 Jahre  entstand  dann  dieses  Buch,  das  unser  gesamtes  GEM-Know- 
How  beinhaltet.  Es  ist  sowohl  fur  den  Anfanger,  der  noch  gar  keine  Kenntnisse  iiber  GEM 
hat,  als  auch  fur  den  Fortgcschrittenen  gedacht,  der  sein  Wissen  noch  erweitern  mdchte. 
Der  Progranimierer  findet  hierin  ein  machtiges  Werkzeug  zur  Entwicklung  portabler  und 
komplexer  GEM-Applikationen. 


' I 


Gunther  Bengel 


Hiithig 

Betriebssysteme  - 
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1 990,  237  S..  62  Abb.,  kart, 
DM  58,— 

ISBN  3-7785-1989-1 


Ein  Betriebssystem  gehbrt  zu 
jedem  Rechner.  Es  verwaltet 
die  Hardware  und  Software 
und  vereinfacht  die  Bedienung 
und  Anwendung  des  Rechners 
fCir  den  Benutzer. 

Ausgehend  von  einer  abstrak- 
ten  Maschine  bespricht  der 
Autor  zunachst  einen  Be- 
triebssystemkern  mit  minima- 
lem  Funktionsumfang  (ProzeS- 
verwaltung,  -umschaltung  und 
-synchronisation,  Ein-/Ausga- 
be,  Zeitdienst).  Darauf  werden 
schrittweise  und  systematisch 
die  verschiedenen  weiteren 
Komponenten  eines  Betriebs- 
systems  (Scheduler,  komfort- 
ablere  Synchronisations-  und 
Kommunikationsfunktionen, 
Hauptspeicher-,  Gerate  und 
Datelverwaltung)  aufgebaut 
Zur  Beschreibung  der  Algo- 
rithmen,  der  Verdeutlichung 
der  strukturellen  Zusammen- 
hange  zwischen  den  ver- 
schiedenen Komponenten  und 
zur  Abstraktion  von  Details 
dient  die  Programmiersprache 
Ada. 


Die  Darstellung  orientiert  sich 
nicht  an  einem  speziellen  kon- 
kreten  Betriebssystem,  son- 
dern  an  dem  allgemeinen  Auf- 
bau fijr  die  meisten  Betriebs- 
systeme, wobei  jedoch  diese 
Prinzipien  durch  Bezug  auf 
konkrete  Betriebssysteme 
(Unix,  DOS,  VAX- VMS)  unter- 
mauert  werden. 


o 


Hiithig  Buch  Verlag 
Im  Weiher  10 
6900  Heidelberg  1 


Arnold  Hickersberger 
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Mit  C zum  Zie 

!l 

Das  C-Buch  fur  Ein-  und  Umsteiger 

1989, 192  S-,  kart.,  DM  38,— 

-,-v  1 ^ 

ISBN  3-7785-1555-1 

Das  Buch  bietet  eine  Einfiih- 
rung  in  die  Programmierspra- 
che  C.  Der  Sprachbeschrei- 
bung  ist  der  Standard  von 
Kerninghan  und  Ritchie  zu 

Grunde  gelegt.  Schwerpunkte 
wurden  in  folgenden  Berei- 
chen  gelegt:  Datentypen,  Spei- 
cherklassen,  Operatoren,  Kon- 
trollstrukturen,  Zeiger  und  Fel- 
der, Funktionen,  Strukturen, 
Varianten  und  Bitfelder,  Ein- 
und  Ausgabe,  Praprozessor. 
Die  Beispiele  sind  nicht  rech- 
nerabhangig. 

: • 

Das  Buch  wendet  sich  speziell 
an  Leser  mit  Vorkenntnissen  in 

PASCAL  Oder  BASIC. 
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Dieses  Lehrbuch  stellt  Richtlinien  fur  die  Soft- 
wareentwickiung  unter  GEM  auf.  Sie  gelten  sowohl 
auf  dem  Atari  ST  ais  auch  auf  dem  IBM-PC  und 
dazu  kompatiblen  Rechnern  sowie  fiir  aile  Versionen 
von  GEM,  vom  Ur-GEM  iiber  GEM/3  bis  zum  X/GEM. 

Sie  konnen  dieses  Werk  ais  INSIDE  GEM  ansehen, 
das  Softwareentwicklung  unter  GEM  inklusive 
Theorie  der  Benutzeroberfidchen  vollst^ndig  be- 
schreibt.  Es  entstand  in  Zusammenarbeit  mit  der 
Atari  Computer  GmbH  und  Digital  Research. 

Entwickler  miissen  mit  diesem  Tool  nur  noch  einen 
minimalen  Aufwand  betreiben,  um  perfekte  Software 
unter  GEM  zu  erstellen.  Sie  miissen  lediglich  die 
Funktionaiitat  Ihrer  Appiikation  an  das  vorhandene 
Skeiett-Programm  SCRAP  anhangen  und  die  Regein 
in  Kapitel  5 beachten.  Die  kompiexe  Steuerung  von 
Software  unter  einer  graphischen  Oberflache  wird 
ihnen  dabei  komplett  abgenommen. 

Einige  Highlights  der  Entwicklung:  Es  wurden  Routi- 
nen  impiementiert,  die  z.B.  Pop-Up-Menus  Oder 
Meniizeiien  in  Fenstern  moglich  machen.  Auch 
Accessories  diirfen  einen  eigenen  Desktop  haben. 
Dieser  wird  dann  in  ein  Fenster  geiegt.  Die  entspre- 
chenden  Routinen  werden  jeweils  genau  erlautert. 

in  der  Neuauflage  wurden  neben  vieien  Kleinig- 
keiten  folgende  Erweiterungen  vorgenommen: 

- Unterstiitzung  beider  Mausknopfe 

- modaie  und  nicht-modale  Dialogboxen  in  echten 
Fenstern 

- erweiterte  Aiertboxen  in  echten  Fenstern 

- blinde  PaBwort-Eingabe 

- Unterstiitzung  der  TOS  1.4  File-Selector-Box 

- Listboxen  in  Diaiogboxen. 

Mit  der  hier  beschriebenen  Methode  konnen  Sie 
GEM-Software  so  entwickein,  daB  sie  auf  jedem 
Rechner  (PC  Oder  ST),  mit  jedem  Betriebssystem, 
mit  jeder  Aufidsung,  mit  jeder  GEM-Version,  ais  Pro- 
gramm  Oder  Accessory  mit  jedem  Compiler  Iduft. 
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